StandardNotes-Server

StandardNotes-Server

Application Docker from junkerderprovinz Repository

Vue d'ensemble

Standard Notes self-hosted backend for Unraid (community template). End-to-end encrypted notes, sync, files, auth and API gateway in the official standardnotes/server image. Required side containers, in this order: 1. MariaDB. Create an empty database "standard_notes_db" and a user "std_notes_user" with all privileges on it. 2. Redis (default port 6379, no auth). 3. StandardNotes-LocalStack companion (SNS and SQS). The server resolves the hostname "localstack" at port 4566. Without it, files-worker.log fills with "getaddrinfo ENOTFOUND localstack" and notes can duplicate. 4. This template. Generate three 32-byte hex secrets before starting: openssl rand -hex 32 (run three times) Ports: 3000/tcp - API gateway (HTTP, put behind a reverse proxy). 3125/tcp host - 3104 container - files server (per upstream docker-compose). Reverse-proxy traffic must forward to host port 3125. URL and cookie shapes: COOKIE_DOMAIN: bare domain only, no https://, no trailing slash. Example: standardnotesserver.mydomain.tld PUBLIC_FILES_SERVER_URL: full HTTPS URL, includes https://. Example: https://files.standardnotesserver.mydomain.tld Custom Sync Server (entered in the Standard Notes client): full HTTPS URL. Example: https://standardnotesserver.mydomain.tld Notes: Unofficial community template. Always reach the server over HTTPS. The web client (standardnotes/web) is a separate Unraid template in the companion repo standardnotes-webui (container name "StandardNotes-WebUI"). See the project README for details. Hostname "localstack" resolution: User-defined Docker network: put both containers on the same custom bridge and give LocalStack the network alias "localstack". br0 / macvlan / VLAN / static-IP install: put LocalStack on the same VLAN with a fixed IP, then append --add-host=localstack:LocalStack-IP to this container's Extra Parameters and restart. Verify with: docker exec StandardNotes-Server getent hosts localstack Notes can duplicate in seconds if Redis, LocalStack, COOKIE_DOMAIN, the reverse proxy, or the image tag is misconfigured. Always test with a fresh throwaway account and one client first. See the README section "Sync-Loop / Duplicate Notes Guardrails".

Exigences

A separately running MariaDB container, a Redis container, and the StandardNotes-LocalStack companion. The server resolves the hostname "localstack" at port 4566 for SNS / SQS. On br0 / macvlan / VLAN / static-IP installs, give LocalStack a fixed IP on the same VLAN and APPEND `--add-host=localstack:LocalStack-IP` to Extra Parameters. See the project README.

Arguments d'exécution

Interface utilisateur Web
http://[IP]:[PORT:3000]/healthcheck
Réseau
bridge
Coquille
sh
Privilégié
false
Paramètres supplémentaires
--restart=unless-stopped

Configuration du modèle

API / Gateway PortPorttcp

HTTP port of the Standard Notes API gateway. Put behind a reverse proxy with HTTPS. Do not expose directly to the public internet.

Cible
3000
Défaut
3000
Valeur
3000
Logs PathPathrw

Persistent server logs.

Cible
/var/lib/server/logs
Défaut
/mnt/user/appdata/standardnotes/logs
Valeur
/mnt/user/appdata/standardnotes/logs
Uploads PathPathrw

Persistent storage for encrypted file uploads.

Cible
/opt/server/packages/files/dist/uploads
Défaut
/mnt/user/appdata/standardnotes/uploads
Valeur
/mnt/user/appdata/standardnotes/uploads
MariaDB HostVariable

IP address of your MariaDB container.

Cible
DB_HOST
Défaut
192.168.x.x
Valeur
192.168.x.x
MariaDB PortVariable

MariaDB server port. Default 3306.

Cible
DB_PORT
Défaut
3306
Valeur
3306
MariaDB UserVariable

Database user. Must match the user created in MariaDB.

Cible
DB_USERNAME
Défaut
std_notes_user
Valeur
std_notes_user
MariaDB PasswordVariable

Password for the MariaDB user above.

Cible
DB_PASSWORD
MariaDB Database NameVariable

Database name. Must already exist. Empty is fine; migrations run on first start.

Cible
DB_DATABASE
Défaut
standard_notes_db
Valeur
standard_notes_db
Database DriverVariable

Leave at 'mysql'. Internal TypeORM driver value used to talk to MariaDB. Do not change.

Cible
DB_TYPE
Défaut
mysql
Valeur
mysql
Redis HostVariable

IP address of your Redis container.

Cible
REDIS_HOST
Défaut
192.168.x.x
Valeur
192.168.x.x
Redis PortVariable

Redis server port. Default 6379. Reachability must be tested from inside this container (same network namespace the server uses). See README for the exact node TCP probe.

Cible
REDIS_PORT
Défaut
6379
Valeur
6379
Cache BackendVariable

Cache backend. Leave at 'redis'.

Cible
CACHE_TYPE
Défaut
redis
Valeur
redis
JWT SecretVariable

Required. 32-byte hex secret. Generate with: openssl rand -hex 32. Changing this invalidates all existing sessions.

Cible
AUTH_JWT_SECRET
Auth Server Encryption KeyVariable

Required. 32-byte hex secret. Generate with: openssl rand -hex 32. Encrypts data at rest server-side. Back it up. Losing it means losing access to that data.

Cible
AUTH_SERVER_ENCRYPTION_SERVER_KEY
Valet Token SecretVariable

Required. 32-byte hex secret. Generate with: openssl rand -hex 32. Signs short-lived upload/download tokens for the files server.

Cible
VALET_TOKEN_SECRET
Public Files Server URLVariable

Optional. Full HTTPS URL of the files server. Includes the https:// scheme. Example: https://files.standardnotesserver.mydomain.tld. Set only if you reverse-proxy the files server on its own subdomain. Leave empty to skip attachments; note creation, editing, and sync work without it.

Cible
PUBLIC_FILES_SERVER_URL
Files Server PortPorttcp

Host port 3125 maps to container port 3104. Forward your reverse proxy to host port 3125 (not 3104). Upstream's docker-compose maps 3125 host to 3104 container.

Cible
3104
Défaut
3125
Valeur
3125
Cookie DomainVariable

Bare domain only. No https://, no trailing slash, no path. Example: standardnotesserver.mydomain.tld. Wrong: https://standardnotesserver.mydomain.tld. A URL here breaks session cookies. The Custom Sync Server URL entered into clients is a separate value and is a full HTTPS URL.

Cible
COOKIE_DOMAIN

Télécharger les statistiques

323,353
Total des téléchargements

Détails

Référentiel
standardnotes/server:latest
Dernière mise à jour2026-04-11
Première vue2026-05-13

Exécutez StandardNotes-Server sur Unraid.

StandardNotes-Server est listé dans Community Apps pour Unraid OS. Explorez Unraid pour créer un serveur domestique flexible, un NAS ou un laboratoire domestique.