Wiki source code of Docker Swarm for XWiki

Last modified by Vincent Massol on 2026/07/27 15:28

Show last authors
1 [[Docker Swarm>>https://docs.docker.com/engine/swarm/]] is a container orchestration mode for Docker that allows you to deploy and manage multi-container applications across one or more Docker hosts. Instead of starting containers manually with [[Docker Run>>doc:documentation.xs.admin.installation.methods.install-xwiki-docker.docker-run.WebHome]] or locally with [[Docker Compose>>doc:documentation.xs.admin.installation.methods.install-xwiki-docker.docker-compose.WebHome]], Docker Swarm uses stack definitions to deploy services in a managed cluster environment. XWiki can be deployed with Docker Swarm by using the XWiki Docker images together with a stack file.
2
3 Docker Swarm also provides additional features that are useful in production environments, including:
4
5 * [[Docker secrets>>https://docs.docker.com/engine/swarm/secrets/]] for sensitive values such as database usernames and passwords.
6 * [[Docker configs>>https://docs.docker.com/engine/swarm/configs/]] for external configuration files.
7
8 When you deploy XWiki with Docker Swarm, Docker can automatically:
9
10 * create overlay networks for the services
11 * run the XWiki and database services
12 * manage persistent volumes
13 * restart failed services
14 * scale services when needed
15
16 A typical XWiki Swarm deployment includes:
17
18 * one XWiki service
19 * one database service (for example MySQL)
20 * persistent volumes for application and database data
21 * secrets for database credentials
22
23 With Docker Swarm, XWiki can be deployed using stack files, such as:
24
25 * [[Run XWiki (MySQL on Tomcat) Using Docker Swarm>>doc:documentation.xs.admin.installation.methods.install-xwiki-docker.docker-swarm.run-xwiki-mysql-tomcat.WebHome]]
26 * [[Run XWiki (MariaDB on Tomcat) Using Docker Swarm>>doc:documentation.xs.admin.installation.methods.install-xwiki-docker.docker-swarm.run-xwiki-mariadb-tomcat.WebHome]]
27 * [[Run XWiki (PostgreSQL on Tomcat) Using Docker Swarm>>doc:documentation.xs.admin.installation.methods.install-xwiki-docker.docker-swarm.run-xwiki-postgresql-tomcat.WebHome]]

Get Connected