Self-hosting with Docker

These instructions make the following assumptions:

  • You've just finished setting up a Linux server (say, Ubuntu 20.04 64-bit) and have installed Docker and Docker Compose on it.
  • You've configured your security groups to allow for incoming SSH connections from your local IP.
  • You've configured a domain name (or subdomain) to point to your server's IP address.
  • You've configured the DNS to enable HTTPS for your domain (say, using Cloudflare).

Getting started

SSH into your server and follow the steps below:

  1. Update your system:

    $ sudo apt-get update
    $ sudo apt-get upgrade
  2. Install git and libmysqlclient-dev:

    $ sudo apt-get install -y git libmysqlclient-dev
  3. Make sure you are in your home directory and clone the Standard Notes Server syncing-server project:

    $ cd ~
    $ git clone --single-branch --branch master https://github.com/standardnotes/syncing-server.git
    $ cd syncing-server

Note: The master branch has the latest, stable code. Use this branch in production environments.

  1. Create .env file in the project's directory:

    $ cp env.sample .env

    Generate the secret key base and paste the output in the .env file's SECRET_KEY_BASE key:

    $ openssl rand -hex 64
  2. Simply run:

    $ sudo docker-compose up -d

    This should load the syncing-server on http://localhost:3000 and MySQL database containers and run the necessary migrations.

  3. Test your access to the server locally:

    $ curl {domain name}
    <!doctype html>
    <html>
    ...
    <body>
    <h1> Hi! You're not supposed to be here. </h1>
    <p> You might be looking for the <a href="https://app.standardnotes.org"> Standard Notes Web App</a> or the main <a href="https://standardnotes.org"> Standard Notes Website</a>. </p>
    </body>
    </html>
  4. You're done!

Using your new server

You can immediately start using your new server by using the Standard Notes app at https://app.standardnotes.org.

In the account menu, choose Advanced Options and enter the address of your new server in Sync Server Domain.

Then, register for a new account or log into an existing account and begin using your private new secure Standard Notes server!

Last updated on