Whatbox Logo
Login for certain variables to be updated with your slot's information

Wiki > Syncthing

Syncthing is an open-source peer-to-peer synchronization tool.

Two random port numbers between 10000 and 65535 are needed for Syncthing to operate properly. The port numbers 12979 and 22489 have automatically been generated and will be used throughout this article, but can be changed if needed.


Syncthing is available as an app on your Manage page. Select Manage Apps next to the slot you want to use Syncthing on. On this page, select Add Syncthing and provide your Whatbox password. After a short wait, you can click Open Syncthing to open Syncthing. You can also access Syncthing from your Manage page.

Manual installation (previous installs)

  1. Connect to your slot through SSH

  2. Download the latest version

     wget -O ~/syncthing.tar.gz $(curl -sL http://git.io/vEPSt | grep -P 'browser(.*)linux-amd64' | cut -d\" -f4)
  3. Extract Syncthing

     mkdir -p ~/syncthing; tar -xvzf ~/syncthing.tar.gz --strip 1 -C ~/syncthing
  4. Generate Syncthing's configuration files by running ~/syncthing/syncthing -generate="~/.config/syncthing"

  5. Open ~/.config/syncthing/config.xml for editing (nano ~/.config/syncthing/config.xml)

  6. Change the IP and port used by the web interface by editing the following lines. is used to allow you to connect to it from the Internet instead of requiring an SSH tunnel.

     <gui enabled="true" tls="false" debugging="false">
  7. Change the port used by Syncthing's listen address by editing the following lines.

  8. Run Syncthing in a screen session. Once Syncthing is running, you may close the SSH session or press Ctrl+A, D to detach from screen, allowing Syncthing to run in the background.

     screen -S syncthing ~/syncthing/syncthing
  9. Navigate to the WebUI by entering http://server.whatbox.ca:12979 into your browser. At the top-right of the page, select Actions followed by Settings. In the settings panel, change your GUI Authentication Username and GUI Authentication Password to a username and password of your choosing.

  10. (Optional) Clean up by removing the Syncthing install archive

    rm ~/syncthing.tar.gz


The user manual and FAQ for Syncthing operation can be found here.


  • You can access the Syncthing WebUI by entering http://server.whatbox.ca:12979 into your browser.

Automatically Restart

Below are steps to take to have your Syncthing instance automatically restart if it crashes, or if the server is rebooted.

  1. Make a file to be used for the script. touch ~/syncthing_restart.cron

  2. Edit the file and enter the text below. nano -w ~/syncthing_restart.cron

    if pgrep -f "/home/user/syncthing/syncthing" > /dev/null
        echo "Syncthing is running."
        echo "Syncthing is not running, starting Syncthing"
        screen -dmS syncthing ~/syncthing/syncthing
  3. Save the file with Ctrl+x, y and Enter to accept overwriting.

  4. Make the script executable. chmod +x ~/syncthing_restart.cron

  5. Open your crontab. EDITOR=nano crontab -e

  6. Enter the following text at the end of the file.

    @reboot /home/user/syncthing_restart.cron >/dev/null 2>&1
    */5 * * * * /home/user/syncthing_restart.cron >/dev/null 2>&1
  7. Save the crontab with Ctrl+x, y and Enter to accept overwriting.