CLI Commands

This page lists every command you need to install, develop, and operate Marketix — from the Composer convenience scripts through the custom marketix:* Artisan commands to the standard Laravel commands operators use in production.

Docker users run php artisan commands inside the app container:

docker compose exec app php artisan <command>

---

Composer scripts

These scripts are defined in composer.json and wrap the most common multi-step workflows.

Script	Invocation	What it does
setup	composer run setup	Full first-time setup: installs PHP dependencies, copies .env.example → .env if missing, generates APP_KEY, runs migrations, installs Node dependencies, and builds frontend assets.
dev	composer run dev	Local development server: starts php artisan serve, queue:listen, pail (log tail), and npm run dev (Vite HMR) concurrently via concurrently.
test	composer run test	Clears the config cache, then runs the PHPUnit test suite via php artisan test.

Tip

Use composer run dev for local development. It starts all required processes in one terminal. For Docker/Octane deployments the dev script is not used — Octane and Horizon are managed by the container supervisor instead.

---

Custom Artisan commands

marketix:create-admin

Creates a new super-admin user, or promotes an existing user to super admin.

php artisan marketix:create-admin [options]

Options

Option	Description
--name=	Admin display name. Prompted interactively if omitted.
--email=	Admin email address. Prompted interactively if omitted.
--password=	Admin password. Prompted securely (with confirmation) if omitted.
--force	Skip the confirmation prompt when promoting an existing user.

Behavior

• If a user with the given email already exists, the command promotes them to super admin. It never resets their existing password.
• If no user exists, it creates a new user with the supplied credentials and the super_admin flag set.
• If the email already belongs to a super admin, the command exits successfully with no changes.

See First Run for the walkthrough of creating your first admin after installation.

---

marketix:geoip:update

Downloads the MaxMind GeoLite2-City database and saves it to storage/app/geoip/GeoLite2-City.mmdb.

php artisan marketix:geoip:update

Requires MAXMIND_LICENSE_KEY to be set (see Environment Variables). The database is approximately 60 MB; the command temporarily raises the PHP memory limit to 512 MB for extraction.

This command runs automatically via the scheduler every day. See Operations for setup instructions.

---

marketix:geoip:test

Looks up a single IP address against the local GeoLite2 database and prints the result as a table.

php artisan marketix:geoip:test {ip}

Arguments

Argument	Description
ip	The IP address to look up (IPv4 or IPv6).

Returns country, region, city, and related fields. If the database is not present, the command instructs you to run marketix:geoip:update first. A missing city is expected for datacenter, VPN, and anycast ranges — the GeoLite2 free database frequently resolves these to country level only.

---

marketix:demo:setup

Resets the database and seeds demo users, projects, domains, and short links. Destructive — runs migrate:fresh against the configured database.

php artisan marketix:demo:setup [--force]

Options

Option	Description
--force	Skip the interactive “Are you sure?” prompt (which otherwise requires typing yes).

Danger

This command drops all data. Never run it on a production instance.

---

Standard Laravel / Horizon / Octane commands

These are standard framework commands operators commonly need. Refer to the Laravel, Horizon, and Octane documentation for full option references.

Database

# Run pending migrations
php artisan migrate

# Fresh install (drops all tables then re-migrates — DESTRUCTIVE)
php artisan migrate:fresh

Queue (Horizon)

# Start Horizon (manages all queue workers)
php artisan horizon

# Pause all Horizon workers
php artisan horizon:pause

# Resume paused workers
php artisan horizon:continue

# Graceful shutdown (let running jobs finish)
php artisan horizon:terminate

Scheduler

# Run the scheduler (typically via a cron entry calling this every minute)
php artisan schedule:run

# List all scheduled tasks and their next run time
php artisan schedule:list

The following tasks are scheduled automatically:

Task	Frequency
marketix:geoip:update	Daily
activitylog:clean	Daily
Domain status check	Every 15 minutes

Octane

# Start the Octane server
php artisan octane:start

# Reload workers (zero-downtime deploy)
php artisan octane:reload

# Stop the Octane server
php artisan octane:stop

# Show current server status
php artisan octane:status

Cache and config

# Cache config, routes, views, and events for production
php artisan optimize

# Clear all caches
php artisan optimize:clear

# Cache config only
php artisan config:cache

# Clear config cache
php artisan config:clear