Skip to content
The Standard Notes syncing server
Ruby HTML Other
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
app Backups sender email Dec 8, 2019
config Update rvm ruby Jan 2, 2020
db Add migration version Dec 5, 2019
lib Initial commit Dec 4, 2019
log Initial commit Dec 4, 2019
public Initial commit Dec 4, 2019
spec Initial commit Dec 4, 2019
.gitignore update gitignore Dec 5, 2019
Capfile Initial commit Dec 4, 2019
Dockerfile Fix docker issues with the rails command Jan 3, 2020
Gemfile add docker_development env and set to use sqlite3 Dec 6, 2019
Gemfile.lock working docker_development environment outputting logs to STDOUT Dec 6, 2019
LICENSE Add license file Dec 6, 2019 added docker-compose Dec 12, 2019
Rakefile Initial commit Dec 4, 2019
app.json fix: add app.json as Heroku requires for deployment Jan 15, 2020 Initial commit Dec 4, 2019
env.sample update env sample file variables Dec 12, 2019

Standard Notes Syncing Server

Running your own server

You can run your own Standard Notes server and use it with any Standard Notes app. This allows you to have 100% control of your data. This server is built with Ruby on Rails and can be deployed in minutes.

Getting started


  • Ruby 2.3+
  • Rails 5
  • MySQL 5.6+ database


  1. Clone the project:

    git clone
  2. Create a .env file in the project's root directory. See env.sample for required values.

  3. Initialize project:

    bundle install
    rails db:create db:migrate
  4. Start the server:

    rails s

Docker Setup

Docker is the quick and easy way to try out Standard Notes. With two commands you'll be up and running.

Standalone Instance

The Dockerfile is enough to get you up and running. Once Docker is installed on your system simply run the following commands to get up and running in Development Mode.

$ docker build -t syncing-server .
$ docker run -d \
  -p 3000:3000 \
  --name my-syncing-server \

You can then access the server via the Desktop application by setting the Sync Server Domain (Under Advanced Options) to http://localhost:3000

Note: This standalone setup is designed for Development use only. Please use the docker-compose method for production instances.

Docker Compose

Use the included docker-compose.yml file to build Standard Notes with docker-compose. Once your .env file has been copied and configured, simply run:

docker-compose up -d

This should load the syncing-server and MySQL database containers and run the necessary migrations. You should then be able to reach the server at http://localhost:[EXPOSED_PORT] . For example, if inside of my .env file I set "EXPOSED_PORT=7459" I could reach the syncing-server via http://localhost:7459

To stop the server, cd into this directory again and run docker-compose down

Your MySQL Data will be written to your local disk at /var/lib/mysql - Be sure to back this up in a production instance.

You can’t perform that action at this time.