It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Confluence Docker image stuck on setup

Alexis Robert Community Leader Apr 07, 2020



I am trying to migrate my current Confluence Server instance to Docker. I want to keep using my current database, so I'm running the container with the following command line :

docker run -v /opt/confluence_home:/var/atlassian/application-data/confluence --name="confluence" -d -p 8090:8090 -p 8091:8091 -e ATL_DB_TYPE=mssql -e ATL_JDBC_USER=confluence -e ATL_JDBC_PASSWORD=xxx -e 'ATL_JDBC_URL=jdbc:sqlserver://myip:1433;databaseName=confluence' atlassian/confluence-server:6.13.3


However, this always starts the Confluence setup process, when I'm expecting it to use the current data in the database.

I have used the Jira and Bitbucket Docker previously images with exactly the same expectations (passing database information to Docker) and in both cases it just starts and does not take me to a setup screen.


Is this normal behaviour for Confluence ? 





1 answer

0 votes
Dave Chevell Atlassian Team Apr 10, 2020

Hey @Alexis Robert ,


When you pass DB configuration to our Confluence docker image, it will dynamically generate a confluence.cfg.xml file inside $CONFLUENCE_HOME containing this configuration, that Confluence will then use.

However, if there's an existing confluence.cfg.xml file inside $CONFLUENCE_HOME, we won't overwrite it for safety reasons - it's only intended to supply configuration to a new installation.

That being the case, I'd recommend that you check the contents of /opt/confluence_home on your host machine. Do you already have a copy of confluence.cfg.xml there? If so, Confluence will simply continue using this. If this were a new install I'd say just rename it to something else and retry; however if this is an existing instance there may be other critical configuration stored inside this file so you might be safest ensuring the existing configuration is correct.

I hope that helps Alexis!


Alexis Robert Community Leader Apr 10, 2020

Hi @Dave Chevell , 


thanks for the quick answer ! I actually tried passing these DB arguments with an empty confluence_home folder, and it was not created on startup (whereas this was working fine with the other Docker images for Jira and Bitbucket).

The only workaround was, as you said, having an existing confluence.cfg.xml in the target confluence_home folder.

Is it possible that it's a bug for the Confluence Docker image ? 





Dave Chevell Atlassian Team Apr 10, 2020

Are you by any chance using an old version of the image? If I pull atlassian/confluence-server (any tag) I cant reproduce this - confluence.cfg.xml gets created.

If you can supply an example of the exact docker run command you’re using I can try it out and see if something is amiss!  

Alexis Robert Community Leader Apr 12, 2020

Hi @Dave Chevell , 


I tried with both 6.13.3 and 7.3.4 images from the official docker repo. Here's my docker run command :

docker run -v /opt/confluence_home:/var/atlassian/application-data/confluence --name="confluence" --user 1001 -d -p 8090:8090 -p 8091:8091 -e ATL_DB_TYPE=mssql -e ATL_JDBC_USER=confluence -e ATL_JDBC_PASSWORD=xxx -e 'ATL_JDBC_URL=jdbc:sqlserver://xxx:1433;databaseName=confluence' atlassian/confluence-server:6.13.3


The database settings passed to Docker are correct because Confluence setup won't show me the database settings page and skip right to the License setup page.

The /opt/confluence_home directory is empty when I'm running this of course.


Thanks for your help !



Suggest an answer

Log in or Sign up to answer
Community showcase
Posted in Confluence

Lessons and Learnings: Six Months of Working Remote [Discussion]

Hey there, folks! For most of us, the past six months- yes, you read that right- have been a journey. More people than ever before have pivoted to working remotely, and navigating being on-scre...

8,341 views 6 6
Join discussion

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you