Skip to content

Added documentation for dev mode#22

Merged
yaronkoren merged 9 commits intomainfrom
devmode
Jan 27, 2026
Merged

Added documentation for dev mode#22
yaronkoren merged 9 commits intomainfrom
devmode

Conversation

@cicalese
Copy link
Contributor

@cicalese cicalese commented Jan 23, 2026

Document the new development mode features for Canasta CLI:

  • Creating dev mode installations with --dev flag
  • Specifying image tags with --dev-tag
  • Building from local source with --build-from
    • Canasta/ (required)
    • CanastaBase/ (optional)
    • Canasta-DockerCompose/ (optional)
  • Enabling/disabling dev mode on existing installations
  • IDE setup for VSCode and PHPStorm
  • Xdebug trigger configuration (cookies for browser, env vars for CLI)
  • Directory structure and log locations
  • Troubleshooting guide
  • Command reference for create, start, and restart

Also document running Canasta on non-standard ports:

  • Configuring HTTP_PORT and HTTPS_PORT in .env
  • Including port in domain name and wikis.yaml
  • Example: running two wiki farms on the same server

Related PRs:

Copy link
Member

@yaronkoren yaronkoren left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks great!

@yaronkoren yaronkoren merged commit 6a96e20 into main Jan 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants