About Canasta ▼

Contents Version history FAQ Notable usage About the project

Download and setup ▼

Prerequisites Standard download

Manual download

Kubernetes

Using Canasta ▼

Command-line interface Packages

Development

Canasta: Download and setup > Manual download

The following instructions are placed here for the sake of completeness, but doing a manual download is discouraged; you are most likely better off using the standard download instead.

Import existing wiki

• Clone the stack repository from https://github.com/CanastaWiki/Canasta-DockerCompose and cd into that directory
• If you need to use Canasta 1.2 instead of Canasta 1.3, do git checkout 1.2.x
• Copy .env.example to .env and customize as needed (more details on how to configure it are in the Configuration section)
• Drop your database dump (in either a .sql or .sql.gz file) into the _initdb/ directory
• Place your existing LocalSettings.php in the config/ directory and change your database configuration to be the following:
  • Database host: db
  • Database user: root
  • Database password: mediawiki (by default; see Configuration section)
• Navigate to the repo directory and run docker compose up -d
• Visit your wiki at its URL (or https://localhost if installed locally)

Create new wiki

• Clone the stack repository from https://github.com/CanastaWiki/Canasta-DockerCompose and cd into that directory
• If you need to use Canasta 1.2 instead of Canasta 1.3, do git checkout 1.2.x
• Copy .env.example to .env and customize as needed (more details on how to configure it are in the Configuration section)
• Navigate to the repo directory and run docker compose up -d
• Navigate to its URL (or https://localhost if installed locally) and run the MediaWiki setup wizard with the following info:
  • Database host: db
  • Database user: root
  • Database password: mediawiki (by default; see Configuration section)
• Place your new LocalSettings.php in the config/ directory
  • We've already added a file in the config/settings/ directory to enable the Vector skin by default, so your wiki will work right off the bat. But feel free to delete this if you are going to use another skin.
  • Be sure to add wfLoadExtension( 'VisualEditor' ); for VisualEditor, etc. (More information about installing extensions can be found at the extensions setup page.)
• Run docker compose down, then docker compose up -d (this is important because it initializes your LocalSettings.php for Canasta)
• Visit your wiki at its URL (or http://localhost if installed locally)