Mediawiki Setting Up Guide

MediaWiki Docker Setup Guide

This guide walks you through setting up MediaWiki using Docker and Dockhand. Follow the steps carefully, as specific paths are required for extensions and configuration to work correctly.

Getting Started

Before proceeding, make sure you have access to a Linux server or local machine with sudo privileges.

Installation Steps

1. Install Docker and Docker Compose

Ensure that Docker and Docker Compose are installed on your system. These tools are required to run MediaWiki and its supporting services in containers.

2. Set Up Dockhand

Dockhand provides a simple web-based interface for managing Docker stacks.

Run the following command in your terminal:

# Use matching paths with DATA_DIR 
docker run -d \
  --name dockhand \
  -p 3000:3000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /opt/dockhand:/opt/dockhand \
  -e DATA_DIR=/opt/dockhand \
  fnsys/dockhand:latest

Once the container is running, open your browser and go to:

http://localhost:3000

You should now see the Dockhand web interface.

3. Create the MediaWiki Stack Directory

Next, create a dedicated directory on the Docker host for your MediaWiki stack.

This location is important because it will store your configuration files and extensions.

Run the following commands:

sudo mkdir -p /opt/stacks/mediawiki
sudo mkdir -p /opt/stacks/mediawiki/extensions
cd /opt/stacks/mediawiki

4. Create the Docker Compose File

Inside the /opt/stacks/mediawiki directory, create a Docker Compose file:

touch docker-compose.yml

This file will later contain the service definitions for MediaWiki, the database, and related components.