Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

This is an old revision of the document!


How to Setup Docker on Ubuntu

Before starting, if you intend to use YOURNAME.synchro.net, you should go ahead and create an account on |Vertrauen in order to access DoveNet as well as the synchro.net dynamic dns service. You can also bring your own registered domain, or use any domain (such as YOURNAME.bbs.io) via freedns.afraid.org.

You should create a public/private key pair for SSH before creating your VM, for many providers, this will allow you to have passwordless SSH access.

Installing Ubuntu Server

You should start with a fresh install of Ubuntu Server. You should use the latest LTS version (As of today, 20.04). If you want to use a web host, you can use Digital Ocean, Linode or almost any other Linux VPS provider.

I would suggest using a VPS with at least 2GB Ram, even though you can get by with less, I would not recommend this.

When creating your Droplet/VM, specify a host name that matches the name the server will use such as foo.synchro.net or foo.bbs.io.

After your VM/VPS is up and running, connect over SSH, edit /etc/ssh/sshd_config and set the port to something other than 22 (such as 65022) so that the default port is available to Synchronet, then restart the server.

After you have changed the SSH port, and restarted, connect again over SSH.

  ssh -p 65022 root@yourserver
  

Now you should install and enable ufw (ubuntu's Uncomplicated Firewall).

  sudo apt-get install ufw
  ufw allow 65022
  ufw enable

Installing Docker

I'm using the instructions from docker.com here for x86_64, you can use the instructions on that site for other platforms.

If using a VPS with root, you can omit the sudo portion of the commands below.

  sudo apt-get update
  sudo apt-get install \
       apt-transport-https \
       ca-certificates \
       curl \
       gnupg-agent \
       software-properties-common
       
  curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
  
  sudo add-apt-repository \
       "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
       $(lsb_release -cs) \
       stable"
       
  sudo apt-get update
  
  sudo apt-get install docker-ce docker-ce-cli containerd.io
  

Finally, in addition to the instructions on docker.com, install docker-compose

  sudo apt-get isntall docker-compose

Installing Synchronet

Now that you have Docker installed and prepared, you can Install Synchronet for Docker.

After installing Synchronet, you should enable the ports that Synchronet expects to use.

  ufw enable 
  ufw enable 80
  ufw enable 443
  ufw enable 1123
  ufw enable 11235
  ufw enable 21
  ufw enable 22
  ufw enable 23
  ufw enable 513
  ufw enable 64
  ufw enable 128
  ufw enable 25
  ufw enable 587
  ufw enable 465
  ufw enable 110
  ufw enable 995
  ufw enable 119
  ufw enable 563
  ufw enable 18
  ufw enable 11
  ufw enable 17
  ufw enable 79
  ufw enable 6667

See Also