CLI:Canasta add

canasta > add

canasta add

Add a new wiki to a Canasta instance

Synopsis

Add a new wiki to an existing Canasta installation, creating a wiki farm. The new wiki is registered in wikis.yaml, the Caddyfile is regenerated, and the MediaWiki installer runs for the new wiki. You can also import an existing database dump instead of running the installer.

canasta add [flags]

Examples

  # Add a wiki accessible at localhost/docs
  canasta add -i myinstance -w docs -u localhost/docs

  # Add a wiki on a different domain
  canasta add -i myinstance -w blog -u blog.example.com

  # Add a wiki with an existing database dump
  canasta add -i myinstance -w docs -u localhost/docs -d /path/to/dump.sql

Flags

Flag	Shorthand	Description	Default	Required
--admin	-a	Admin name of the new wiki	WikiSysop
--database	-d	Path to existing database dump (.sql or .sql.gz) to import instead of running install.php
--help	-h	help for add
--id	-i	Canasta instance ID	instance associated with current directory
--password	-s	Admin password for the new wiki (if not provided, auto-generates and saves to config/admin-password_{wikiid})
--site-name	-t	Display name of the wiki	wiki ID
--url	-u	URL of the new wiki (domain/path format, e.g., 'localhost/wiki2' or 'example.com/mywiki'; do not include protocol/scheme)		✓
--wiki	-w	ID of the new wiki		✓
--wiki-settings	-l	Path to per-wiki settings file to copy to config/settings/wikis/<wiki_id>/ (filename preserved)
--wikidbuser		The username of the wiki database user	root
--verbose	-v	Verbose output