canasta add

Add a new wiki to a Canasta instance

Synopsis

Add a new wiki to an existing Canasta instance, 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, or pass --skip-install to connect to an external database that already holds the new wiki's schema.

canasta add [flags]

Examples

canasta add -w docs -u localhost/docs

Flags

Flag	Shorthand	Description	Default	Required	Orchestrator
`--admin`	`-a`	Initial wiki admin username			Both
`--database`	`-d`	Path to existing database dump			Both
`--id`	`-i`	Canasta instance ID	*		Both
`--images`	`-I`	Path to a tar (.tar or .tar.gz) of the new wiki's images directory at the hash-directory level (0/, 1/, archive/, ...). Its files are copied into the wiki's uploads (images/<wiki>/) as www-data — a placement restore, not importImages. Pairs with --database, which supplies the File: page rows; a leading images/ parent is elided.			Both
`--password`	`-s`	Initial wiki admin password			Both
`--site-name`	`-t`	Display name of the wiki			Both
`--skip-install`		Skip the MediaWiki installer (install.php) and connect to a database that already has the new wiki's schema. Requires the instance to use USE_EXTERNAL_DB=true and cannot be combined with --database.			Both
`--url`	`-u`	Domain/path for the wiki (e.g. localhost/docs)		✓	Both
`--wiki`	`-w`	ID of the wiki		✓	Both
`--wiki-settings`	`-l`	Path to per-wiki Settings.php			Both
`--wikidbuser`		Wiki database username			Both

* Defaults to the Canasta instance matching the current directory, if any.

Global flags

Flag	Shorthand	Description	Default	Required	Orchestrator
`--help`	`-h`	Show help message and exit			Both
`--verbose`	`-v`	Enable verbose output			Both