Skip to content

Set Up Standard Notes on a Linux Server – Build Your Private Note System

Discover how to securely sync and protect your notes across devices with Standard Notes self-hosting → Learn more now

12 November 20264 min read21 Views0 helpful

Introduction

Standard Notes is an open-source note-taking app that protects your data with verified end-to-end encryption. Only you control the decryption keys. It seamlessly syncs your encrypted notes and files across unlimited devices, keeps them available offline, and actively protects your content from external access.

Thinking about self-hosting this service? We guide you step-by-step through the setup and configuration and show you everything you need to consider.

Requirements

Before installing Standard Notes, make sure your hosting environment meets the following requirements to ensure smooth installation and optimal performance.

HardwareMinimumZAP Hosting Recommendation
CPU1 vCPU core4 vCPU cores
RAM2 GB4 GB
Storage5 GB25 GB

The software requires all necessary dependencies to be installed and to run on a supported operating system. Verify that your server meets the following requirements before starting the installation:

Dependencies: Docker (Engine 26+ and Compose)

Operating System: Latest version of Ubuntu/Debian with Docker 26+ support

Ensure all dependencies are installed and the correct OS version is used to avoid compatibility issues when installing Standard Notes.

Preparation

Before setting up Standard Notes, you need to prepare your system. This includes updating your operating system and installing all required dependencies. This preparation ensures a stable environment and helps prevent issues during or after installation.

Update System

To run your system with the latest software and security updates, first perform an update by running:

Code
sudo apt update && sudo apt upgrade -y

This ensures your system has the latest security patches and software versions before installation.

Install Dependencies

After the update completes, you can start installing dependencies. Standard Notes runs on your server using multiple Docker containers. Docker must be installed first. Run the following commands:

Code
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

A detailed guide on installing and using Docker is available in our Docker tutorial.

Installation

Once all requirements are met and preparations are complete, you can start installing Standard Notes.

First, create a folder to hold all configuration and setup files. This folder will be your working directory for the installation.

Code
mkdir standardnotes
cd standardnotes

Next, create a .env file in your working directory and fill it with the default values from the project's sample configuration:

Code
touch .env
curl https://raw.githubusercontent.com/standardnotes/server/main/.env.sample > .env

This file contains only the minimally required variables for a functional setup. The full list of currently used variables can be found here: docker-entrypoint.sh

Open the .env file and ensure all keys in the KEYS section are set correctly. Generate random values for each required environment variable with:

Code
openssl rand -hex 32

Insert these values into your .env file. Standard Notes requires a bootstrap script for LocalStack. Download it to your working directory and make it executable:

shell
curl https://raw.githubusercontent.com/standardnotes/server/main/docker/localstack_bootstrap.sh > localstack_bootstrap.sh
chmod +x localstack_bootstrap.sh

Download the official sample configuration and save it as docker-compose.yml in your working folder. This file defines all container services needed for Standard Notes.

Code
curl https://raw.githubusercontent.com/standardnotes/server/main/docker-compose.example.yml > docker-compose.yml

When everything is ready, pull the latest images and start the services in the background:

Code
docker compose pull && docker compose up -d

Configuration

You can customize the default configuration in the provided docker-compose.yml file to fit your individual needs. An important area is the server service, where you can change port mappings in the ports property. This determines which host ports the application will be accessible through—helping avoid conflicts with other services or adapting your network setup.

Securing the database is another crucial step. Replace default passwords with strong, randomly generated strings. You can create a secure password like this:

Code
openssl rand -hex 12  

Add the generated value as DB_PASSWORD in the .env file. The same value must also be set for MYSQL_ROOT_PASSWORD and MYSQL_PASSWORD in the docker-compose.yml to keep the containers synchronized.

These configuration changes ensure your installation not only works but is also secure and tailored to your environment.

Connecting to the Sync Server

To set up your account in Standard Notes, click the avatar icon at the bottom right of the app. In the menu that appears, select “Create Account” to create a new user profile. Enter a valid email address and a secure password.

Before completing the process, open the “Advanced Options” section. Under “Sync Server,” select the “Custom” option and enter your own server’s IP address and port in the format IP:Port. This way, your notes will sync not via the official Standard Notes service but through your self-hosted server.

Completion and Additional Resources

Congratulations! You have successfully installed and configured Standard Notes on your VPS/Dedicated Server. We also recommend checking out the following resources to help with server configuration:

Do you have specific questions not answered here? Our team is available daily for further questions or support—just get in touch! 🙂

FAQ

Frequently asked questions

Standard Notes is an open-source note app that protects your data with verified end-to-end encryption. It syncs encrypted notes and files across unlimited devices and keeps them available offline.
Minimum requirements are 1 vCPU core, 2 GB RAM, and 5 GB storage. ZAP Hosting recommends 4 vCPU cores, 4 GB RAM, and 25 GB storage.
Standard Notes requires Docker (Engine 26+ and Compose) and runs on the latest Ubuntu/Debian version with Docker 26+ support.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 people found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Zappy knows this guide and answers you right in the chat.