Settings, Updates & Licensing | Canopy Docs - Canopy
Documentation

Migrated user-facing app documentation, including screenshots and the same step-by-step document flow.

Settings, Updates & Licensing

Key settings

In Settings, you can:

  • Choose your IDE and terminal
  • Toggle theme preferences
  • Manage service ports (via Service Settings)
  • Install or update the bundled canopy CLI and view its status Tool selection/settings screen showing IDE and terminal choices Temporary verification: settings/tools view for IDE + terminal picker controls (and related setup status context).

Auto-updates

Canopy checks for updates automatically. You can also check manually from the app menu or status bar menu.

Licensing and trial

Canopy offers a 14-day free trial. Licenses are tied to your account and can be activated on up to two machines.

Crash reporting (opt-in)

Crash reporting is optional and disabled by default. If enabled, reports are sanitized to remove personal information before being sent.

Example Canopy stack .env overrides (advanced)

If you need to avoid port conflicts or change the default project location, keep overrides small and intentional:

PROJECTS_DIR=~/Projects
NGINX_HTTP_PORT=8080
NGINX_HTTPS_PORT=8443
POSTGRES_PORT=5433
XDEBUG_PORT=9003

After saving settings, Canopy restarts affected services automatically.

Next up

Learn the built-in Keyboard Shortcuts.