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

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
howto:docker [2021/02/24 12:59] – created hubhowto:docker [2021/05/04 16:19] (current) – [Installing Synchronet] tracker1
Line 4: Line 4:
  
 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. 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.
 +
 +==== Windows Users ====
 +
 +Windows Users should [[https://docs.microsoft.com/en-us/windows/wsl/install-win10|Install WSL2]] on a recent version of Windows 10 followed by [[https://www.microsoft.com/en-us/p/ubuntu-2004-lts/9n6svws3rx71?activetab=pivot:overviewtab|Ubuntu 20.04]] in the Windows Store, then install [[Docker Desktop for Windows]].
 +
 +With the above in place, you can then refer to [[install:docker|Install Synchronet for Docker]] and disregard any Docker or UFW directions below.
 +
  
 ===== Installing Ubuntu Server ===== ===== Installing Ubuntu Server =====
Line 9: Line 16:
 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 [[https://www.digitalocean.com/|Digital Ocean]], [[https://www.linode.com/|Linode]] or almost any other Linux VPS provider. 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 [[https://www.digitalocean.com/|Digital Ocean]], [[https://www.linode.com/|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.+It is recommended to use a VPS with at least 2GB Ram for Docker usage.
  
 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. 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.
Line 27: Line 34:
 ===== Installing Docker ===== ===== Installing Docker =====
  
-I'm using the [[https://docs.docker.com/engine/install/ubuntu/|instructions from docker.com]] here for x86_64, you can use the instructions on that site for other platforms.+The instructions in this section are copied from docker.org for x86_64, for other platforms [[https://docs.docker.com/engine/install/ubuntu/|click here]].
  
 If using a VPS with root, you can omit the //sudo// portion of the commands below. If using a VPS with root, you can omit the //sudo// portion of the commands below.
Line 48: Line 55:
                    
     sudo apt-get update     sudo apt-get update
 +    
     sudo apt-get install docker-ce docker-ce-cli containerd.io     sudo apt-get install docker-ce docker-ce-cli containerd.io
          
 Finally, in addition to the instructions on docker.com, install //docker-compose// Finally, in addition to the instructions on docker.com, install //docker-compose//
 +
 +    sudo apt-get install docker-compose
  
 ===== Installing Synchronet ===== ===== Installing Synchronet =====
Line 59: Line 68:
 After installing Synchronet, you should enable the ports that Synchronet expects to use. After installing Synchronet, you should enable the ports that Synchronet expects to use.
  
-    ufw enable  +    ufw allow 80 
-    ufw enable 80 +    ufw allow 443 
-    ufw enable 443 +    ufw allow 1123 
-    ufw enable 1123 +    ufw allow 11235 
-    ufw enable 11235 +    ufw allow 21 
-    ufw enable 21 +    ufw allow 22 
-    ufw enable 22 +    ufw allow 23 
-    ufw enable 23 +    ufw allow 513 
-    ufw enable 513 +    ufw allow 64 
-    ufw enable 64 +    ufw allow 128 
-    ufw enable 128 +    ufw allow 25 
-    ufw enable 25 +    ufw allow 587 
-    ufw enable 587 +    ufw allow 465 
-    ufw enable 465 +    ufw allow 110 
-    ufw enable 110 +    ufw allow 995 
-    ufw enable 995 +    ufw allow 119 
-    ufw enable 119 +    ufw allow 563 
-    ufw enable 563 +    ufw allow 18 
-    ufw enable 18 +    ufw allow 11 
-    ufw enable 11 +    ufw allow 17 
-    ufw enable 17 +    ufw allow 79 
-    ufw enable 79 +    ufw allow 6667 
-    ufw enable 6667+ 
 +===== Remote Editing ===== 
 + 
 +In order to make life easier, you may consider installing [[https://code.visualstudio.com/download|Visual Studio Code]] and then install the [[https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack|Remote Development]] extension pack, which will allow for SSH and WSL remote editing. 
 + 
 +The following contents in //sbbs/.vscode/settings.json// will make using VS Code easier and align well with the files in your //sbbs// directory.
  
 +    {
 +      "files.associations": {
 +        "*.ssjs": "javascript",
 +      },
 +      "[plaintext]": {
 +        "files.encoding": "cp437",
 +        "editor.renderControlCharacters": true,
 +      }
 +    }
 ===== See Also ===== ===== See Also =====
   * [[:howto:|howto index]]   * [[:howto:|howto index]]

Trace: • Clean-Up