Additional Setup ‐ Migrate CRCON to another VPS

🧭 You are here : Wiki home / Additional Setup / Migrate CRCON to another VPS

---

Table of Contents

• Migrate CRCON to another VPS
• On your "old" VPS
  • 1. Login to SSH
  • 2. Stop CRCON
  • 3. Create an archive of CRCON folder
  • 4. Transfer archive via SCP
• On your "new" VPS
  • 5. Login to SSH
  • 6. Check software requirements
  • 7. Extract archive
  • 8. Start CRCON
  • 9. Change the server_url parameter in CRCON's settings
  • 10. Change urls in Scorebot config
  • 11. Restart CRCON

Migrate CRCON to another VPS

Here's the procedure to migrate your CRCON instance to another server.

Warning

Proceed at your own risk : this may lead to data loss if not done correctly.

On your "old" VPS

1. Login to SSH

See this guide to get into a SSH terminal prompt.

Note

We'll assume you have installed CRCON in its default /root/hll_rcon_tool folder, following the installation guide.
Adapt the commands given below if necessary.

2. Stop CRCON

Stop the CRCON instance to ensure there is no data getting in/out the Postgres database.

cd /root/hll_rcon_tool
docker compose down

Note : /root/hll_rcon_tool is the location of the crcon directory. Yours may be installed elsewhere.

3. Create an archive of CRCON folder

tar -czvf crcon.tar.gz /root/hll_rcon_tool

Warning

You can choose to send the whole hll_rcon_tool uncompressed folder to a new computer.
You may face file permissions issues if the files are stored on a Windows computer while transiting.
Some of them will loose the "execution" bit, leading to a non-working CRCON.
To fix it, you'll have to execute chmod commands :

chmod +x /root/hll_rcon_tool/entrypoint.sh
chmod +x /root/hll_rcon_tool/manage.py
chmod +x /root/hll_rcon_tool/rcongui/entrypoint.sh
chmod +x /root/hll_rcon_tool/rconweb/manage.py

4. Transfer archive via SCP

Transfer the crcon.tar.gz file using SCP to the new server.

Replace user and new_server_ip with your "new" VPS root credentials.

scp crcon.tar.gz user@new_server_ip:/root

You'll get a password prompt.
Enter the "root" user's password (it won't display for security reasons), then press the [Enter] key.

(Optional) delete the archive

rm crcon.tar.gz

On your "new" VPS

5. Login to SSH

See this guide to get into a SSH terminal prompt.

Note

We'll assume you have installed CRCON in its default /root/hll_rcon_tool folder, following the installation guide.
Adapt the commands given below if necessary.

6. Check software requirements

You must have Docker and the Docker compose plugin installed.

Follow the Software requirements instructions on the installation manual.

7. Extract archive

Enter the /root folder and extract the archive

cd /root
tar -xvf crcon.tar.gz

(Optional) delete the extracted archive

rm crcon.tar.gz

8. Start CRCON

Enter the hll_rcon_tool folder and launch CRCON.

cd hll_rcon_tool
docker compose up -d

9. Change the server_url parameter in CRCON's settings

Enter your new VPS IP in CRCON's settings, as described in the installation guide.

10 (optional). Change urls in Scorebot config

Enter your new VPS IP in Scorebot's settings :

• base_api_url
• base_scoreboard_url

11. Restart CRCON

docker compose down
docker compose up -d