CLI Commands

Operational reference for the artisan commands you run to deploy, maintain, and operate Inventorix.

Local dev (DDEV): prefix every command with ddev artisan, e.g. ddev artisan migrate.
Docker / production: run commands inside the app container, e.g. docker exec -it <container> php artisan migrate.

Deployment & migrations

Command	Description
`php artisan migrate`	Run pending database migrations.
`php artisan migrate --force`	Run migrations in production (bypasses the interactive prompt). The Docker image runs this automatically on start when `RUN_MIGRATIONS=true`.
`php artisan db:seed`	Seed the database. Creates the default admin account (`hello@noix.dev` / `Start23!`). Change the password immediately after first login.
`php artisan key:generate`	Generate and write a new `APP_KEY` to `.env`. Required on first setup.
`php artisan filament:upgrade`	Update Filament internal assets after a package upgrade. Run after `composer update`.
`php artisan filament:assets`	Re-publish Filament static assets. Run if the UI looks broken after a deployment.

Queues & Horizon

Inventorix uses the database queue driver by default. For production workloads, switch to redis and use Horizon.

Command	Description
`php artisan queue:work`	Process jobs from the default queue. Use in simple single-server setups.
`php artisan horizon`	Start Laravel Horizon (Redis-backed queue manager with a dashboard). Requires `QUEUE_CONNECTION=redis`.

See Queues configuration and Operations.

Scheduler

The task scheduler dispatches commands on a timed basis. In production, a single cron entry drives the scheduler:

* * * * * php artisan schedule:run >> /dev/null 2>&1

Command	Description
`php artisan schedule:run`	Execute all due scheduled tasks once. Called by the system cron every minute.
`php artisan schedule:work`	Start the scheduler in the foreground (polls every minute). Useful in Docker containers instead of a system cron.

Scheduled tasks

Schedule	Command	Description
Daily at 07:00	`warranty:scan-expiries`	Scan asset warranty/guarantee end dates and send an expiry digest email.

Warranty scanner

Command	Signature
Scan warranty expiries	`php artisan warranty:scan-expiries`

Scans all assets with a guarantee_end date and sends a grouped expiry digest email to the configured recipients. Skips silently if warranty notifications are disabled in Settings or no recipients are configured.

This command has no CLI options. Behaviour is controlled entirely through the Warranty settings in the admin UI (enable/disable, lead-time days, recipient list).

See Notifications for how warranty alerts work from the user’s perspective.

Activity log

Command	Description
`php artisan activitylog:clean`	Delete old activity log entries. Uses the retention period configured in `config/activitylog.php` (default: 365 days). Run periodically to keep the `activity_log` table from growing unbounded.

See Operations.

Cache & optimisation

Run these after deploying a new version or changing configuration.

Command	Description
`php artisan config:cache`	Serialise all config files into a single cache file. Do not run in local dev — cached config ignores `.env` changes.
`php artisan route:cache`	Cache the route list. Speeds up route resolution.
`php artisan view:cache`	Pre-compile all Blade views.
`php artisan event:cache`	Cache event/listener discovery.
`php artisan optimize`	Runs `config:cache`, `route:cache`, `view:cache`, and `event:cache` together.
`php artisan optimize:clear`	Clear all caches created by `optimize`.

Octane

Command	Description
`php artisan octane:start`	Start the Octane application server (used in the Docker image). Defaults to the FrankenPHP or Swoole driver as configured in `config/octane.php`.
`php artisan octane:reload`	Reload Octane workers without dropping existing connections. Use after a code deploy.
`php artisan octane:stop`	Stop the Octane server.