Canasta: Using Canasta > Create wikis

The following covers how to create wikis via the Canasta command-line interface (CLI). For information on how to create them manually, see Manual download.

Create a wiki

Run the following command to create a new Canasta installation with default configurations. This will create a folder named canastaId in the directory in which you're running this command.
```
sudo canasta create -i canastaId -n example.com -w Canasta Wiki -a admin -o compose
```
Visit your wiki at its URL; for the above command, it would be https://example.com. (if Canasta is installed locally or you did not specify any domain, it would be http://localhost.)

Import an existing wiki

Place all the files mentioned below in the same directory for ease of use.
Create a .env file and customize as needed (more details on how to configure it at configuration, and for an example see .env.example).
Drop your database dump (in either a .sql or .sql.gz file).
Place your existing LocalSettings.php and change your database configuration to be the following:
- Database host: db
- Database user: root
- Database password: mediawiki (by default; see Configuration)

Then run the following command:

sudo canasta import -i importWikiId -d ./backup.sql.gz -e ./.env -l ./LocalSettings.php

Visit your wiki at its URL (or http://localhost if installed locally or if you did not specify any domain).

Create additional wikis (wiki farm)

You can create additional wikis on the same server by calling canasta create to create additional Canasta instances, but the generally much better approach is to call canasta add, which adds additional wikis to the same Canasta instance, thus turning the installation into what is known as a "wiki farm". A typical call on a server with the domain example.com might look like:

sudo canasta create -i canastaId -w soccerwiki -u soccer.example.com -s "Soccer Wiki" -a admin

There are various other flags for canasta add (10 in all); an important additional one is --database or -d, which lets you specify an existing database dump, thus providing an equivalent call to canasta import for a wiki farm setup.

There is no limit to how many wikis can be run within the same Canasta installation. As is typical for wiki farms, all wikis within the same installation will run on the same software, but using different databases and images directories.

To view all wikis within any installation, call canasta list; it will list all Canasta installations on the server, a well as all wikis contained within each installation.

To delete a specific wiki, but not the whole Canasta installation, call canasta delete; a typical call would look like:

sudo canasta remove -i canastaId -w soccerwiki