Configuration Reference

This document describes all environment variables and configuration options for notifito.

Environment Variables

Core Application (apps/core)

VariableRequiredDefaultDescription
APP_NAMENoLaravelApplication name
APP_ENVNolocalEnvironment (local, production, testing)
APP_KEYYes—Laravel encryption key (32 chars, base64)
APP_DEBUGNotrueEnable debug mode
APP_URLYes—Application URL (e.g., https://core.notifito.com)
APP_TIMEZONENoUTCApplication timezone
LOG_CHANNELNostackLog channel (stack, stderr, single)
DB_CONNECTIONNopgsqlDatabase driver
DB_HOSTYespostgresPostgreSQL host
DB_PORTYes5432PostgreSQL port
DB_DATABASEYesnotifito_coreDatabase name
DB_USERNAMEYesnotifitoDatabase user
DB_PASSWORDYesnotifitoDatabase password
REDIS_HOSTYesredisRedis host
REDIS_PORTYes6379Redis port
CACHE_STORENoredisCache driver
QUEUE_CONNECTIONNoredisQueue driver
SESSION_DRIVERNoredisSession driver
INTERNAL_SECRETYes—Shared secret for internal API
EDGE_URLYes—Edge service URL for building links

Edge Application (apps/edge)

VariableRequiredDefaultDescription
APP_NAMENoLaravelApplication name
APP_ENVNolocalEnvironment
APP_KEYYes—Laravel encryption key
APP_DEBUGNotrueEnable debug mode
APP_URLYes—Application URL
LOG_CHANNELNostackLog channel
DB_CONNECTIONNonullDatabase driver (edge has no database)
REDIS_HOSTYesredisRedis host
REDIS_PORTYes6379Redis port
CACHE_STORENoredisCache driver
QUEUE_CONNECTIONNoredisQueue driver
INTERNAL_SECRETYes—Shared secret for internal API
CORE_URLYes—Core service URL
DISPATCH_URLYes—Dispatch service URL
KEY_CACHE_SECONDSNo60API key cache TTL
POSTMARK_WEBHOOK_USERYes—Postmark webhook basic auth user
POSTMARK_WEBHOOK_PASSWORDYes—Postmark webhook basic auth password

Dispatch Application (apps/dispatch)

VariableRequiredDefaultDescription
APP_NAMENoLaravelApplication name
APP_ENVNolocalEnvironment
APP_KEYYes—Laravel encryption key
APP_DEBUGNotrueEnable debug mode
APP_URLYes—Application URL
LOG_CHANNELNostackLog channel
DB_CONNECTIONNopgsqlDatabase driver
DB_HOSTYespostgresPostgreSQL host
DB_PORTYes5432PostgreSQL port
DB_DATABASEYesnotifito_dispatchDatabase name
DB_USERNAMEYesnotifitoDatabase user
DB_PASSWORDYesnotifitoDatabase password
REDIS_HOSTYesredisRedis host
REDIS_PORTYes6379Redis port
CACHE_STORENoredisCache driver
QUEUE_CONNECTIONNoredisQueue driver
INTERNAL_SECRETYes—Shared secret for internal API
POSTMARK_API_KEYYes—Postmark API token
POSTMARK_BASE_URLNohttps://api.postmarkapp.comPostmark API URL
POSTMARK_MESSAGE_STREAMNo—Postmark message stream ID
MAIL_FROM_ADDRESSYes—Sender email address

Dashboard Application (apps/dashboard)

VariableRequiredDefaultDescription
APP_NAMENoLaravelApplication name
APP_ENVNolocalEnvironment
APP_KEYYes—Laravel encryption key
APP_DEBUGNotrueEnable debug mode
APP_URLYes—Application URL
LOG_CHANNELNostackLog channel
DB_CONNECTIONNonullDatabase driver (dashboard has no database)
REDIS_HOSTYesredisRedis host
REDIS_PORTYes6379Redis port
CACHE_STORENoredisCache driver
SESSION_DRIVERNoredisSession driver
QUEUE_CONNECTIONNosyncQueue driver
CORE_URLYes—Core service URL
INTERNAL_SECRETYes—Shared secret for internal API

Admin Application (apps/admin)

VariableRequiredDefaultDescription
CORE_URLYes—Core service URL
INTERNAL_SECRETYes—Shared secret for internal API

Docker Compose Configuration

Service Definitions

yaml
services:

tools:

# Development container with PHP, Composer, Node.js

postgres:

# PostgreSQL 18 database

image: postgres:18-alpine

ports: ["55432:5432"]

redis:

# Redis 8 cache/queue

image: redis:8-alpine

ports: ["56379:6379"]

core:

# Core domain service

command: php artisan serve --host=0.0.0.0 --port=8000

edge:

# Public API service

command: php artisan serve --host=0.0.0.0 --port=8000

ports: ["8000:8000"]

dispatch:

# Email delivery service

command: php artisan serve --host=0.0.0.0 --port=8000

dashboard:

# Seller UI service

command: php artisan serve --host=0.0.0.0 --port=8000

admin:

# Admin UI service

command: php artisan serve --host=0.0.0.0 --port=8000

core-horizon:

# Core queue worker (Horizon)

command: php artisan horizon

dispatch-horizon:

# Dispatch queue worker (Horizon)

command: php artisan horizon

caddy:

# Reverse proxy

image: caddy:2-alpine

ports: ["80:80", "443:443"]


Horizon Configuration

Core Horizon (apps/core/config/horizon.php)

php
'environments' => [

'production' => [

'supervisor-matching' => [

'connection' => 'redis',

'queue' => ['core-matching'],

'balance' => 'auto',

'minProcesses' => 1,

'maxProcesses' => 6,

'tries' => 5,

'timeout' => 120,

],

'supervisor-delivery' => [

'connection' => 'redis',

'queue' => ['core-delivery'],

'balance' => 'auto',

'minProcesses' => 1,

'maxProcesses' => 3,

'tries' => 5,

'timeout' => 60,

],

],

],

Dispatch Horizon (apps/dispatch/config/horizon.php)

php
'environments' => [

'production' => [

'supervisor-send' => [

'connection' => 'redis',

'queue' => ['dispatch-send'],

'balance' => 'auto',

'minProcesses' => 1,

'maxProcesses' => 10,

'tries' => 6,

'backoff' => [60, 300, 900, 3600, 10800],

'timeout' => 60,

],

],

],


Caddy Configuration

Domain Routing

DomainServicePurpose
edge.notifito.comedgePublic API
app.notifito.comdashboardSeller UI
admin.notifito.comadminAdmin panel
cdn.notifito.comstatic filesWidget bundle

Internal services (core, dispatch) are not exposed to the public internet.


Queue Configuration

Queue Names

QueueServicePurpose
core-matchingcoreAvailability event processing and matching
core-deliverycoreDelivery status updates from dispatch
dispatch-senddispatchEmail sending (confirmations + notifications)

Retry Configuration

QueueTriesBackoffTimeout
core-matching5Default120s
core-delivery5Default60s
dispatch-send660, 300, 900, 3600, 10800s60s

Database Configuration

Database Names

ServiceDatabasePurpose
corenotifito_coreDomain data
core (test)notifito_core_testTesting
dispatchnotifito_dispatchDelivery data
dispatch (test)notifito_dispatch_testTesting

Redis Configuration

Usage

PurposeDatabaseTTL
Cache0Configurable
Queue0—
Session0120 min
Horizon0—

Notifito-Specific Configuration

apps/core/config/notifito.php

php
return [

'internal_secret' => env('INTERNAL_SECRET'),

'edge_url' => env('EDGE_URL'),

'subscriptions' => [

'expiry_days' => 90,

'unconfirmed_purge_hours' => 72,

'notification_cooldown_hours' => 24,

],

];

apps/dashboard/config/notifito.php

php
return [

'core_url' => env('CORE_URL'),

'internal_secret' => env('INTERNAL_SECRET'),

];


Environment File Examples

Development

env
APP_NAME=notifito-core

APP_ENV=local

APP_KEY=base64:generated-key

APP_DEBUG=true

APP_URL=http://core:8000

DB_CONNECTION=pgsql

DB_HOST=postgres

DB_PORT=5432

DB_DATABASE=notifito_core

DB_USERNAME=notifito

DB_PASSWORD=notifito

REDIS_HOST=redis

REDIS_PORT=6379

CACHE_STORE=redis

QUEUE_CONNECTION=redis

SESSION_DRIVER=array

INTERNAL_SECRET=dev-internal-secret

EDGE_URL=http://edge:8000

Production

env
APP_NAME=notifito-core

APP_ENV=production

APP_KEY=base64:strong-random-key

APP_DEBUG=false

APP_URL=https://core.notifito.com

LOG_CHANNEL=stderr

DB_CONNECTION=pgsql

DB_HOST=postgres

DB_PORT=5432

DB_DATABASE=notifito_core

DB_USERNAME=notifito

DB_PASSWORD=strong-database-password

REDIS_HOST=redis

REDIS_PORT=6379

CACHE_STORE=redis

QUEUE_CONNECTION=redis

SESSION_DRIVER=redis

INTERNAL_SECRET=strong-internal-secret

EDGE_URL=https://edge.notifito.com

Testing

env
APP_NAME=notifito-core

APP_ENV=testing

APP_KEY=base64:test-key

APP_DEBUG=true

DB_CONNECTION=pgsql

DB_DATABASE=notifito_core_test

CACHE_STORE=array

QUEUE_CONNECTION=sync

SESSION_DRIVER=array

MAIL_MAILER=array

INTERNAL_SECRET=test-internal-secret

EDGE_URL=http://edge.test


Security Considerations

Secrets Management

Production Hardening

env
APP_DEBUG=false

LOG_CHANNEL=stderr

Database Security