Skip to content

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 -a admin

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

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

Options

Flag Shorthand Description Default
--admin -a Admin name of the new wiki
--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
--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 (optional, defaults to 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// (filename preserved)
--wikidbuser `` The username of the wiki database user (default: "root") root

Options inherited from parent commands

Flag Shorthand Description Default
--verbose -v Verbose output

SEE ALSO

  • canasta - A CLI tool for Canasta installations.