[Tutorial] Migrate Confluence from Cloud to Server

[fengchang]

Migrate Confluence from Cloud to Server might be tricky because you need to reset the admin password in recovery mode. And the official doc doesn't work on a Cloudron instance. Here is how I made it.

Prerequisite:

1. Install cloudron cli npm install -g cloudron
2. Login to your cloudron cloudron login my.domain.com

Export data from Confluence Cloud and import data to Confluence Server:

1. In Confluence Cloud, go to Settings - Backup Manager - Create backup for server. Download the zip file.
2. Install Confluence app on Cloudron
3. Resize the app memory limit to 6GB (Strongly advise to avoid import failure)
4. Use web terminal to get database parameter: cat /app/data/credentials.txt
5. Open your Confluence, setup database connection, import the backup zip file.

After import succeed, you will need to login to Confluence, but the old password doesn't work. Follow these steps to reset admin password:

1. Enable debug mode of your app cloudron debug --app confluence.domain.com
2. Get a shell to your app's docker cloudron exec --app confluence.domain.com
3. Edit file vim /home/cloudron/confluence/bin/setenv.sh
4. Add CATALINA_OPTS="-Datlassian.recovery.password=your_random_password" to the end of file, after the last CATALINA_OPTS line. Save.
5. Start confluence by run /home/cloudron/start.sh
6. Login your confluence with username recovery_admin and the password in step 4.
7. The Confluence site seems empty and ask you to create a space. Don't worry, create a new space.
8. Open Settings - User Management, list all users. Find your old admin user, reset password and add it to all admin groups.
9. Logout, and try login with your admin user. It works!
10. Delete the the CATALINA_OPTS added in setenv.sh
11. Exit from app docker. Disable debug mode by running cloudron debug --disable --app configure.domain.com. Wait the app restart.
12. Your Confluence is ready!

Reference:

• Confluence Official: Migrate from Confluence Cloud to Server
• How to edit file in /home/cloudron

[girish]

@fengchang thanks for the excellent write up.

[marcusquinn]

@fengchang the world thanks you!

(We did similar from hosted to hosted - it's just used as an archive reference now.)