Install Matrix

Use this page to choose the right install path. For the full walkthrough, use the install guide.

Situation	Use	Notes
Fast local demo	Quickstart	Uses demo-friendly defaults and optional package prompts.
Fresh Laravel app	Install guide: fresh application	Best route for a clean production app.
Existing Laravel app	Install guide: existing application	Preserve users, routes, deploy flow, and existing data.
Local monorepo development	Development	Use sibling capell-4 and capell-packages-4 repos with path repositories.
CI or non-interactive install	capell:install --no-interaction with all required flags	Pass URL, admin user, package mode, theme, and cache flags explicitly.
Optional package install	Package README or package docs	Confirm commands with php artisan list capell.
Upgrade existing app	Operations upgrade notes	Back up the database and include optional package migrations.

Non-Interactive Flags

For CI, seed jobs, or agent runs, avoid prompts:

php artisan capell:install \
  --no-interaction \
  --url=https://example.com \
  --package-mode=all \
  --theme=default \
  --name="Admin User" \
  [email protected] \
  --password="change-this-password" \
  --clear-cache \
  --install-welcome-route

This creates the first account and answers every required install decision explicitly. For an existing account, use --user=<email-or-id> instead of the three account-creation options; --user selects the default author and never creates or changes login credentials.

Next

• Install guide
• Development
• Operations