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
Last revisionBoth sides next revision
howto:docker [2021/02/24 12:59] – created hubhowto:docker [2021/02/24 15:53] – [Remote Editing] hub
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 83: Line 92:
     ufw enable 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: