Alertiqo Manager (Self-Hosted)

Run Alertiqo on your own infrastructure with complete control over your error tracking data.

What is Alertiqo Manager?

Alertiqo Manager is a self-hosted Laravel package that provides the same error tracking capabilities as the cloud version, but running entirely on your own servers.

Benefits

• Data Privacy - All error data stays on your servers
• Compliance - Meet regulatory requirements (GDPR, HIPAA, etc.)
• No Limits - No monthly error limits or data retention restrictions
• Customization - Modify the code to fit your needs
• Integration - Integrate with your existing Laravel infrastructure

Requirements

• PHP 8.0 or higher
• Laravel 9.x, 10.x, or 11.x
• MySQL 5.7+ / PostgreSQL 10+ / SQLite
• Composer

Installation

1. Download the Package

Download the latest version from your Downloads page.

2. Extract and Configure Composer

Extract the package and add it to your project's composer.json:

{
    "repositories": [
        {
            "type": "path",
            "url": "./packages/alertiqo-manager"
        }
    ],
    "require": {
        "hymns/alertiqo-manager": "*"
    }
}

3. Install via Composer

composer update

4. Publish Assets

# Publish config
php artisan vendor:publish --tag=alertiqo-manager-config

# Publish migrations
php artisan vendor:publish --tag=alertiqo-manager-migrations

# Publish views (optional, for customization)
php artisan vendor:publish --tag=alertiqo-manager-views

5. Run Migrations

php artisan migrate

6. Configure Environment

Add to your .env file:

# Alertiqo Manager
ALERTIQO_MANAGER_ENABLED=true
ALERTIQO_MANAGER_PATH=alertiqo
ALERTIQO_MANAGER_MIDDLEWARE=web,auth

Usage

Access the Dashboard

Visit /alertiqo (or your configured path) to access the error tracking dashboard.

Create a Project

1. Go to the dashboard
2. Click "Create Project"
3. Enter a project name
4. Copy the generated API key

Configure Your Client SDK

Point your client SDK to your self-hosted instance:

# In your application's .env
ALERTIQO_API_KEY=your-project-api-key
ALERTIQO_ENDPOINT=https://your-domain.com/alertiqo

Features

• ✅ Error tracking and grouping
• ✅ Stack traces with source context
• ✅ Breadcrumbs
• ✅ User context
• ✅ Tags and filtering
• ✅ Notification channels (Slack, Email, Webhook)
• ✅ AI-powered solution suggestions
• ✅ Multi-project support

Configuration Options

The config file (config/alertiqo-manager.php) includes:

return [
    // Enable/disable the manager
    'enabled' => env('ALERTIQO_MANAGER_ENABLED', true),
    
    // URL path for the dashboard
    'path' => env('ALERTIQO_MANAGER_PATH', 'alertiqo'),
    
    // Middleware for dashboard routes
    'middleware' => explode(',', env('ALERTIQO_MANAGER_MIDDLEWARE', 'web,auth')),
    
    // Database connection (null = default)
    'database' => env('ALERTIQO_MANAGER_DATABASE', null),
    
    // Data retention (days, 0 = forever)
    'retention_days' => env('ALERTIQO_MANAGER_RETENTION', 30),
    
    // AI solution provider (openai, anthropic, null)
    'ai_provider' => env('ALERTIQO_MANAGER_AI_PROVIDER', null),
    'ai_api_key' => env('ALERTIQO_MANAGER_AI_KEY', null),
];

Updating

To update Alertiqo Manager:

1. Download the latest version from your Downloads page
2. Replace the package in your packages/ directory
3. Run composer update
4. Run php artisan migrate (if there are new migrations)

Support

For support with Alertiqo Manager, please contact us at [email protected].