Skip to content

Moving an Outline Server's Access Keys to a New Server

Jump to bottom
Ehsan Mohandesi edited this page May 18, 2023 · 4 revisions

One workaround to move your Outline server without your users being notified about it is to use the domain name instead of the server IP. The following explains how to do it.

Using Domain Name Instead of IP

  1. After the Outline server was created and you created the keys, just replace the server IP with the domain name. The following is an example.

ss://Y2hhY2hhMjAtaWV0Zi1wb2x5MTM0zNE43MVZ3SHE2a0xt@45.1.99.29:1727/?outline=1 => ss://Y2hhY2hhMjAtaWV0Zi1wb2x5MTM0zNE43MVZ3SHE2a0xt@ns1.yourdomain.com:1727/?outline=1

  1. Send the keys with domain names to the users.

Moving the Server

In case your Outline server is detected by the repressive government and its IP is blocked, you can move the server to another IP address without your users even experiencing a glitch. Follow these steps.

  1. Create a new Outline server.
  2. Move the file shadowbox_config.json from the old server to the new server using the SCP command.
scp /opt/outline/persisted-state/shadowbox_config.json user@NEW_SERVER_IP:/opt/outline/persisted-state/
  1. Reboot the new server.
  2. Go to the website of your user domain name and point it to the new IP. image

Using the New Server in Outline Manager

Use the access string that was generated when creating the new Outline server.

References

  1. https://github.com/Jigsaw-Code/outline-server/issues/384
Clone this wiki locally