Canasta CLI (command-line interface) tool

This is the official command line interface tool for the Canasta MediaWiki distribution.

Commands

create

Description: Creates a Canasta installation. Enhanced to support wiki farm setup with the -f flag.

Usage: sudo canasta create [flags]

• -p, --path: Canasta directory.
• -o, --orchestrator: Orchestrator to use for installation (default: "compose").
• -i, --id: Canasta instance ID.
• -w, --wiki: Name of the wiki.
• -n, --domain-name: Domain name (default: "localhost").
• -a, --WikiSysop: Initial wiki admin username.
• -s, --password: Initial wiki admin password.
• -f, --yamlfile: Initial wiki yaml file for wiki farm setup.
• -k, --keep-config: Keep the config files on installation failure.
• -r, --override: Name of a file to copy to docker-compose.override.yml.
• --rootdbpass: Read root database user password from .root-db-password file or prompt for it if file does not exist (default password: "mediawiki").
• --wikidbuser: The username of the wiki database user (default: "root").
• --wikidbpass: Read wiki database user password from .wiki-db-password file or prompt for it if file does not exist (default password: "mediawiki").

YAML Format for Wiki Farm: To create a wiki farm, you first need to create a YAML file with the following format:

wikis:
  - id: [WIKI_ID] # Example: "mywiki1"
    url: [WIKI_URL] # Example: "mywiki1.example.com"

Then run the following:

sudo canasta create -f [yamlfile] # Example: "wikis.yaml"

extension

Description: Manage Canasta extensions. Enhanced to target a specific wiki within the farm using the -w flag.

Subcommands:

• list: Lists all the installed Canasta extensions.
• enable: Enables specified extensions.
• disable: Disables specified extensions.

Usage:

sudo canasta extension [subcommand] [flags]

Flags:

• -i, --id: Specifies the Canasta instance ID.
• -p, --path: Specifies the Canasta installation directory.
• -w, --wiki: Specifies the ID of a specific wiki within the Canasta farm.
• -v, --verbose: Enables verbose output.

add

Description: Adds a new wiki to a Canasta instance.

Usage:

sudo canasta add [flags]

Flags:

• -w, --wiki: ID of the new wiki.
• -u, --url: URL of the new wiki.
• -s, --site-name: Name of the new wiki site.
• -p, --path: Path to the new wiki.
• -i, --id: Canasta instance ID.
• -o, --orchestrator: Orchestrator to use for installation (default: "compose").
• -d, --database: Path to the existing database dump.
• -a, --admin: Admin name of the new wiki.
• --wikidbuser: The username of the wiki database user (default: "root").

remove

Description: Removes a wiki from a Canasta instance.

Usage:

sudo canasta remove [flags]

Flags:

• -w, --wiki: ID of the wiki to be removed.
• -p, --path: Path to the wiki.
• -i, --id: Canasta instance ID.