DevOps:Doc/Open CSP/2.0/open-csp-on-canasta

Getting this running is a two-step process, not including preparation of a docker host with all the prereqs that come with that.

First of all we’ll create a new Canasta wiki, and then upgrade it to Open CSP.

Creation of a new Canasta wiki:

For this we’ll use Canasta-DockerCompose.

1. Clone the Canasta-DockerCompose repo, master branch. It can be found here : https://github.com/CanastaWiki/Canasta-DockerCompose
2. Copy the .env.example file to .env (optional; to override default values)
3. Alter .env as needed (refer to https://canasta.wiki/other-maintenance/#configuration )
4. Launch instance ( In your console you to the downloaded files and inside the main folder run : docker-compose up -d )
5. Wait for the database container to become responsive
6. Restart everything ( run docker-compose down, then docker-compose up -d again )
7. Navigate to your webpage (localhost in your web browser on the docker host)
8. Follow the MediaWiki installation steps to install your version of MediaWiki
9. Copy the downloaded LocalSettings.php to <where you installed the download rep in step 1>/config/ on the host
10. Shut down Canasta instance ( run docker-compose down )

The shutdown and restart is needed to make the previously configured (either implicitly by defaults or explicitly through .env) MySQL root password become active.

You may encounter an issue like I did initially where the site will never come online.
In this case use ‘docker logs <container>’ to inspect your MediaWiki container’s goings-on.
It may report that it cannot access files directly under the “/mediawiki/”, in which case shut it down and edit docker-compose.yml as follows:

Under services → web → volumes, at the top, add: - ./mediawiki:/mediawiki

It should then look something like:

web:
    image: ghcr.io/canastawiki/canasta:latest
    restart: unless-stopped
    extra_hosts:
      - "gateway.docker.internal:host-gateway"
    depends_on:
      - db
      - elasticsearch
    environment:
      # Sourced from .env
      - MW_SITE_SERVER=${MW_SITE_SERVER:-https://localhost}
      - PHP_UPLOAD_MAX_FILESIZE=${PHP_UPLOAD_MAX_FILESIZE:-10M}
      - PHP_POST_MAX_SIZE=${PHP_UPLOAD_MAX_FILESIZE:-10M}
      - PHP_MAX_INPUT_VARS=${PHP_MAX_INPUT_VARS:-1000}
      - MW_SITEMAP_SUBDIR
      - MW_SITEMAP_IDENTIFIER
    volumes:
      - ./mediawiki:/mediawiki
      - ./extensions:/var/www/mediawiki/w/user-extensions
      - ./skins:/var/www/mediawiki/w/user-skins
      - ./config:/mediawiki/config
      - ./images:/mediawiki/images
      - sitemap:/mediawiki/sitemap

Then spin the farm up again.

Upgrading to Open CSP:

1. Clone the Canasta-OpenCSP fork, master branch. ( this can be found here : https://github.com/LarsS88/opencsp2-canasta, you can simply download and unzip )
2. Build the image with a tag such as ‘open-csp:2.0’ for instance. ( inside the main folder that you have just downloaded, type docker build --tag open-csp:2.0 . ( do not forget the . at the end )
3. Go back to your Canasta-DockerCompose repo and edit docker-compose.override.yml
4. Uncomment “web” and its “image” property.
5. Set the image to your locally built Canasta-OpenCSP tag. It should look something like this :

services:
  #db:
  web:
    image: open-csp:2.0
  #elasticsearch:
  caddy:
      ports:
      - "${PORT:-80}:80"
      - "${HTTPS_PORT:-443}:443"
  #varnish:

Launch the farm again.