epuzanov/mediawiki repository overview

⁠What is MediaWiki?

MediaWiki is a free and open-source wiki app, used to power wiki websites such as Wikipedia, Wiktionary and Commons, developed by the Wikimedia Foundation and others.

⁠How to use this image

docker run --name wiki -p 80:80 -e MEDIAWIKI_SITE_SERVER=http://wiki.example.com -d epuzanov/mediawiki

Partial explanation of arguments:

• --net allows you to connect this container with a database container. See Configure Database below for more details.
• -v is used to mount a shared folder with the container. See Shared Volume below for more details.

Having troubling accessing your MediaWiki server? See Accessing MediaWiki below for help.

⁠Extra configuration options

Use the following environmental variables to generate a LocalSettings.php and perform automatic installation of MediaWiki.

• -e MEDIAWIKI_SITE_SERVER= (required set this to the server host and include the protocol (and port if necessary) like //wiki; configures $wgServer)
• -e MEDIAWIKI_SITE_NAME= (defaults to MediaWiki; configures $wgSitename)
• -e MEDIAWIKI_SITE_LANG= (defaults to en; configures $wgLanguageCode)
• -e MEDIAWIKI_ADMIN_USER= (defaults to admin; configures default administrator username)
• -e MEDIAWIKI_ADMIN_PASS= (defaults to Pa55word+; configures default administrator password)
• -e MEDIAWIKI_UPDATE=true (defaults to false; run php maintenance/update.php)
• -e MEDIAWIKI_DB_TYPE= (defaults to sqlite; configures $wgDBtype)
• -e MEDIAWIKI_DB_HOST= (defaults to db; configures $wgDBserver)
• -e MEDIAWIKI_DB_PORT= (defaults to 3306; configures $wgDBport)
• -e MEDIAWIKI_DB_SCHEMA= (defaults to mediawiki; configures $wgDBmwschema)
• -e MEDIAWIKI_DB_USER= (defaults to wikiuser; configures $wgDBuser)
• -e MEDIAWIKI_DB_PASS= (defaults to autogenerated; configures $wgDBpassword)
• -e MEDIAWIKI_DB_INSTALL_USER= (defaults depends on MEDIAWIKI_DB_TYPE)
• -e MEDIAWIKI_DB_INSTALL_PASS= (defaults depends on MEDIAWIKI_DB_TYPE)
• -e MEDIAWIKI_DB_NAME= (defaults to wikidb; configures $wgDBname)
• -e MEDIAWIKI_SCRIPTPATH= (defaults to ``; configures $wgScriptPath)
• -e MEDIAWIKI_MEMCACHED= (defaults to ``; configures $wgMemCachedServers)
• -e MEDIAWIKI_LDAP_SERVERS= (defaults to dc.example.com; configures $wgLDAPServerNames)
• -e MEDIAWIKI_LDAP_AGENT= (defaults to cn=proxyagent,ou=Users,dc=example,dc=com; configures $wgLDAPProxyAgent)
• -e MEDIAWIKI_LDAP_AGENT_PASS= (defaults to password; configures $wgLDAPProxyAgentPassword)
• -e MEDIAWIKI_LDAP_BASEDN= (defaults to dc=example,dc=com; configures $wgLDAPBaseDNs)

As mentioned, this will generate the LocalSettings.php file that is required by MediaWiki. If you mounted a shared volume (see Shared Volume below), the generated LocalSettings.php will be automatically moved to your share volume allowing you to edit it.

⁠Choosing MediaWiki version

We currently track latest MediaWiki production branches, as run on wikipedia.org.

• epuzanov/mediawiki:latest (currently uses REL1_30)

⁠Configure Database

The example above uses --net or --link to connect the MediaWiki container with a running mysql⁠ container. This is probably not the best idea for use in production, keeping data in docker containers can be dangerous. Supported Databases:

• MySQL (MEDIAWIKI_DB_TYPE=mysql)
• Postgres (MEDIAWIKI_DB_TYPE=postgres)
• SQLite (MEDIAWIKI_DB_TYPE=sqlite)
• MS SQL (MEDIAWIKI_DB_TYPE=mssql)

⁠Using SQLite

You can use SQLite backand for small MediaWiki setup without dedicated Database Server. MediaWiki SQLite database files will be saved in wiki configuration Shared Volume.

docker run --name wiki -p 80:80 -v /local/wiki_data/path:/data:rw -e MEDIAWIKI_SITE_SERVER=http://wiki.example.com -d epuzanov/mediawiki

⁠Using MySQL

You can use MySQL as your database server:

docker run --name wiki --link some-mysql:db -p 80:80 -v /local/wiki_data/path:/data:rw -e MEDIAWIKI_DB_TYPE=mysql -e MEDIAWIKI_DB_INSTALL_PASSWORD=Pa$$w0rd -e MEDIAWIKI_SITE_SERVER=http://wiki.example.com -d epuzanov/mediawiki

⁠Using Postgres

You can use Postgres instead of MySQL as your database server:

docker run --name wiki --link some-postgres:db -p 80:80 -v /local/wiki_data/path:/data:rw -e MEDIAWIKI_DB_TYPE=postgres -e MEDIAWIKI_DB_INSTALL_PASSWORD=Pa$$w0rd -e MEDIAWIKI_SITE_SERVER=http://wiki.example.com -d epuzanov/mediawiki

⁠Using Database Server

You can use the following environment variables for connecting to another database server:

• -e MEDIAWIKI_DB_TYPE=... (defaults to sqlite, but can also be mysql, postgres or mssql)
• -e MEDIAWIKI_DB_HOST=... (defaults to the address of the linked database container)
• -e MEDIAWIKI_DB_PORT=... (defaults to the port of the linked database container or to the default for specified db type)
• -e MEDIAWIKI_DB_USER=... (defaults to root, sa or postgres based on db type being mysql, mssql or postgres respsectively)
• -e MEDIAWIKI_DB_PASSWORD=... (defaults to the password of the linked database container)
• -e MEDIAWIKI_DB_NAME=... (defaults to mediawiki)
• -e MEDIAWIKI_DB_SCHEMA... (defaults to mediawiki, applies only to when using postgres)
• -e MEDIAWIKI_DB_INSTALL_USER=... (defaults to root, sa or postgres based on db type being mysql, mssql or postgres respsectively)
• -e MEDIAWIKI_DB_INSTALL_PASSWORD=... (defaults to the password of the linked database container)

If the MEDIAWIKI_DB_NAME specified does not already exist on the provided MySQL server, it will be created automatically upon container startup, provided that the MEDIAWIKI_DB_INSTALL_USER specified has the necessary permissions to create it.

To use with an external database server, use MEDIAWIKI_DB_HOST (along with MEDIAWIKI_DB_USER and MEDIAWIKI_DB_PASSWORD if necessary):

docker run --name wiki -e MEDIAWIKI_DB_HOST=10.0.0.1 -e MEDIAWIKI_DB_PORT=3306 -e MEDIAWIKI_DB_USER=wikiuser -e MEDIAWIKI_DB_PASSWORD=password epuzanov/mediawiki

⁠Shared Volume

If provided mount a shared volume using the -v argument when running docker run, the mediawiki container will automatically look for a LocalSettings.php file, Images directory, SSL certificats and wiki.png logo file. This allows you to easily configure (LocalSettings.php), update SSL certificats and MediaWiki Logo. It is highly recommend you mount a shared volume so uploaded files and images will be outside of the docker container. By default the shared volume must be mounted to /data on the container.

⁠Using SSL

Replace server.key and server.crt files on shared volume with you files. docker run --name wiki -p 443:443 -e MEDIAWIKI_SITE_SERVER=https://wiki.example.com⁠ -d epuzanov/mediawiki

⁠Multiple Wikis with mediawiki-fpm

docker run --name wiki1 --net wikinet -v /local/wiki1:/data:rw -e MEDIAWIKI_SITE_SERVER=http://wiki1.example.com -d epuzanov/mediawiki /usr/sbin/php-fpm
docker run --name wiki2 --net wikinet -v /local/wiki2:/data:rw -e MEDIAWIKI_SITE_SERVER=http://wiki2.example.com -d epuzanov/mediawiki /usr/sbin/php-fpm
docker run --name wiki3 --net wikinet -v /local/wiki3:/data:rw -e MEDIAWIKI_SITE_SERVER=http://wiki3.example.com -d epuzanov/mediawiki /usr/sbin/php-fpm
docker run --name httpd --net wikinet -p 80:80 -v /local/wiki1:/data/wiki1:rw -v /local/wiki2:/data/wiki2:rw -v /local/wiki3:/data/wiki3:rw -d epuzanov/mediawiki