Confluence Server is where you create, organise and discuss work with your team. Capture the knowledge that's too often lost in email inboxes and shared network drives in Confluence – where it's easy to find, use, and update. Give every team, project, or department its own space to create the things they need, whether it's meeting notes, product requirements, file lists, or project plans, you can get more done in Confluence.

Learn more about Confluence Server: https://www.atlassian.com/software/confluence

You can find the repository for this Dockerfile at https://hub.docker.com/r/atlassian/confluence-server

Overview

This Docker container makes it easy to get an instance of Confluence up and running.

Quick Start

For the directory in the environmental variable CONFLUENCE_HOME that is used to store Confluence data (amongst other things) we recommend mounting a host directory as a data volume:

Additionally, if running Confluence in Data Center mode it is required that a shared filesystem is mounted. The mountpoint (inside the container) can be configured with CONFLUENCE_SHARED_HOME.

Start Atlassian Confluence Server:

$> docker run -v /data/your-confluence-home:/var/atlassian/application-data/confluence --name="confluence" -d -p 8090:8090 -p 8091:8091 atlassian/confluence-server

Success. Confluence is now available on http://localhost:8090*

Please ensure your container has the necessary resources allocated to it. We recommend 2GiB of memory allocated to accommodate the application server. See Supported Platforms for further information.

* Note: If you are using docker-machine on Mac OS X, please use open http://$(docker-machine ip default):8090 instead.

Memory / Heap Size

If you need to override Confluence Server's default memory allocation, you can control the minimum heap (Xms) and maximum heap (Xmx) via the below environment variables.

• JVM_MINIMUM_MEMORY (default: 1024m)

  The minimum heap size of the JVM

• JVM_MAXIMUM_MEMORY (default: 1024m)

  The maximum heap size of the JVM

Tomcat and Reverse Proxy Settings

If Confluence is run behind a reverse proxy server (e.g. a load-balancer or nginx server), then you need to specify extra options to make Confluence aware of the setup. They can be controlled via the below environment variables.

• ATL_PROXY_NAME (default: NONE)

  The reverse proxy's fully qualified hostname. CATALINA_CONNECTOR_PROXYNAME is also supported for backwards compatability.

• ATL_PROXY_PORT (default: NONE)

  The reverse proxy's port number via which Confluence is accessed. CATALINA_CONNECTOR_PROXYPORT is also supported for backwards compatability.

• ATL_TOMCAT_PORT (default: 8090)

  The port for Tomcat/Confluence to listen on. Depending on your container deployment method this port may need to be [exposed and published][docker-expose].

• ATL_TOMCAT_SCHEME (default: http)

  The protocol via which Confluenceis accessed. CATALINA_CONNECTOR_SCHEME is also supported for backwards compatability.

• ATL_TOMCAT_SECURE (default: false)

  Set 'true' if ATL_TOMCAT_SCHEME is 'https'. CATALINA_CONNECTOR_SECURE is also supported for backwards compatability.

• ATL_TOMCAT_CONTEXTPATH (default: NONE)

  The context path the application is served over. CATALINA_CONTEXT_PATH is also supported for backwards compatability.

The following Tomcat/Catalina options are also supported. For more information, see https://tomcat.apache.org/tomcat-7.0-doc/config/index.html.

• ATL_TOMCAT_MGMT_PORT (default: 8000)
• ATL_TOMCAT_MAXTHREADS (default: 200)
• ATL_TOMCAT_MINSPARETHREADS (default: 10)
• ATL_TOMCAT_CONNECTIONTIMEOUT (default: 20000)
• ATL_TOMCAT_ENABLELOOKUPS (default: false)
• ATL_TOMCAT_PROTOCOL (default: HTTP/1.1)
• ATL_TOMCAT_ACCEPTCOUNT (default: 10)

JVM configuration

If you need to pass additional JVM arguments to Confluence such as specifying a custom trust store, you can add them via the below environment variable

• JVM_SUPPORT_RECOMMENDED_ARGS

  Additional JVM arguments for Confluence

Example:

$> docker run -e JVM_SUPPORT_RECOMMENDED_ARGS=-Djavax.net.ssl.trustStore=/var/atlassian/application-data/confluence/cacerts -v confluenceVolume:/var/atlassian/application-data/confluence --name="confluence" -d -p 8090:8090 -p 8091:8091 atlassian/confluence-server

Confluence-specific settings

• ATL_AUTOLOGIN_COOKIE_AGE (default: 1209600; two weeks, in seconds)

  The maximum time a user can remain logged-in with 'Remember Me'.

• CONFLUENCE_HOME

  The confluence home directory. This may be on an mounted volume; if so it should be writable by the user confluence. See note below about UID mappings.

Database configuration

It is optionally possible to configure the database from the environment, avoiding the need to do so through the web startup screen.

The following variables are all must all be supplied if using this feature:

• ATL_JDBC_URL

  The database URL; this is database-specific.

• ATL_JDBC_USER

  The database user to connect as.

• ATL_JDBC_PASSWORD

  The password for the database user.

• ATL_DB_TYPE

  The type of database; valid supported values are:

  • mssql
  • mysql
  • oracle12c
  • postgresql

The following variables are for the database connection pool, and are optional.

• ATL_DB_POOLMINSIZE (default: 20)
• ATL_DB_POOLMAXSIZE (default: 100)
• ATL_DB_TIMEOUT (default: 30)
• ATL_DB_IDLETESTPERIOD (default: 100)
• ATL_DB_MAXSTATEMENTS (default: 0)
• ATL_DB_VALIDATE (default: false)
• ATL_DB_ACQUIREINCREMENT (default: 1)
• ATL_DB_VALIDATIONQUERY (default: "select 1")

Data Center configuration

This docker image can be run as part of a Data Center cluster. You can specify the following properties to start Confluence as a Data Center node, instead of manually configuring a cluster. See Installing Jira Data Center for more information.

Cluster configuration

Confluence Data Center allows clustering via various methods. For more information on the setting for each type see this page.

Common cluster settings

• ATL_CLUSTER_TYPE

  The cluster type. Setting this effectively enables clustering. Valid values are aws, multicast, and tcp_ip.

• ATL_CLUSTER_NAME

  The cluster name; this should be common across all nodes.

• ATL_PRODUCT_HOME_SHARED

  The location of the shared home directory for all Confluence nodes. Note: This must be real shared filesystem that is mounted inside the container. Additionally, see the note about UIDs.

• ATL_CLUSTER_TTL

  The time-to-live for cluster packets. Primarily of use in multicast clusters.

AWS cluster settints

The following should be populated from the AWS environment.

• ATL_HAZELCAST_NETWORK_AWS_IAM_ROLE
• ATL_HAZELCAST_NETWORK_AWS_IAM_REGION
• ATL_HAZELCAST_NETWORK_AWS_HOST_HEADER
• ATL_HAZELCAST_NETWORK_AWS_SECURITY_GROUP
• ATL_HAZELCAST_NETWORK_AWS_TAG_KEY
• ATL_HAZELCAST_NETWORK_AWS_TAG_VALUE

TCP cluster settings

• ATL_CLUSTER_PEERS

  A comma-separated list of peer IPs.

Multicast cluster settings

• ATL_CLUSTER_ADDRESS

Shared directory and user IDs

By default the Confuence application runs as the user confluence, with a UID and GID of 2002. Consequently this UID must have write access to the shared filesystem. If for some reason a different UID must be used, there are a number of options available:

• The Docker image can be rebuilt with a different UID.
• Under Linux, the UID can be remapped using user namespace remapping.

Upgrade

To upgrade to a more recent version of Confluence Server you can simply stop the Confluence container and start a new one based on a more recent image:

$> docker stop confluence
$> docker rm confluence
$> docker run ... (see above)

As your data is stored in the data volume directory on the host, it will still be available after the upgrade.

Note: Please make sure that you don't accidentally remove the confluence container and its volumes using the -v option.

Backup

For evaluating Confluence you can use the built-in database that will store its files in the Confluence Server home directory. In that case it is sufficient to create a backup archive of the directory on the host that is used as a volume (/data/your-confluence-home in the example above).

Confluence's automatic backup is currently supported in the Docker setup. You can also use the Production Backup Strategy approach if you're using an external database.

Read more about data recovery and backups: Site Backup and Restore

Versioning

The latest tag matches the most recent release of Atlassian Confluence Server. So atlassian/confluence-server:latest will use the newest stable version of Confluence Server available.

Alternatively, you can use a specific minor version of Confluence Server by using a version number tag: atlassian/confluence-server:6.13. This will install the latest 6.13.x version that is available.

For the latest developer (EAP) release use atlassian/confluence-server:eap. This will install our latest milestone (not supported for use in production).

By default our Docker image uses OpenJDK, which is not supported for production sites. However we do provide a fully supported Docker image that uses AdoptOpenJDK 8. These images are tagged with the suffix ubuntu-18.04-adoptopenjdk8 together with the Confluence version.

For example, atlassian/confluence-server:6.13-ubuntu-18.04-adoptopenjdk8 will install the latest 6.13.x version with AdoptOpenJDK 8.

Known Problems

In Mac OS X with Docker version 1.11.0, when running with docker-machine, there is a bug where the directory specified for CONFLUENCE_HOME in a volume mount will not have the correct permission, and thus startup fails with a permission denied error:

 Error writing state to confluence.cfg.xml
 com.atlassian.config.ConfigurationException: Couldn't save confluence.cfg.xml to /var/atlassian/confluence-home directory.

See https://github.com/docker/docker/issues/4023 for details.

To work around this issue, use a different host operating system other than Mac OSX until a newer release of Docker fixes this issue.

Support

These Confluence Docker images are presented as an early-access release, and not recommended for critical production deployments. However if have you an interest in deploying with containers will would be interesting in hearing your feedback.

Note that these images are built on the AdoptOpenJDK images. Prior to Confluence 6.13 OpenJDK was not a supported platform. See the 6.13 release-notes for more information.