StandardNotes-Server

StandardNotes-Server

Docker-Anwendung from junkerderprovinz Repository

Übersicht

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".

Anforderungen

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.

Laufzeit-Argumente

Web-UI
http://[IP]:[PORT:3000]/healthcheck
Netzwerk
bridge
Shell
sh
Privilegiert
false
Extra Params
--restart=unless-stopped

Konfiguration der Vorlage

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.

Ziel
3000
Standard
3000
Wert
3000
Logs PathPathrw

Persistent server logs.

Ziel
/var/lib/server/logs
Standard
/mnt/user/appdata/standardnotes/logs
Wert
/mnt/user/appdata/standardnotes/logs
Uploads PathPathrw

Persistent storage for encrypted file uploads.

Ziel
/opt/server/packages/files/dist/uploads
Standard
/mnt/user/appdata/standardnotes/uploads
Wert
/mnt/user/appdata/standardnotes/uploads
MariaDB HostVariable

IP address of your MariaDB container.

Ziel
DB_HOST
Standard
192.168.x.x
Wert
192.168.x.x
MariaDB PortVariable

MariaDB server port. Default 3306.

Ziel
DB_PORT
Standard
3306
Wert
3306
MariaDB UserVariable

Database user. Must match the user created in MariaDB.

Ziel
DB_USERNAME
Standard
std_notes_user
Wert
std_notes_user
MariaDB PasswordVariable

Password for the MariaDB user above.

Ziel
DB_PASSWORD
MariaDB Database NameVariable

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

Ziel
DB_DATABASE
Standard
standard_notes_db
Wert
standard_notes_db
Database DriverVariable

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

Ziel
DB_TYPE
Standard
mysql
Wert
mysql
Redis HostVariable

IP address of your Redis container.

Ziel
REDIS_HOST
Standard
192.168.x.x
Wert
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.

Ziel
REDIS_PORT
Standard
6379
Wert
6379
Cache BackendVariable

Cache backend. Leave at 'redis'.

Ziel
CACHE_TYPE
Standard
redis
Wert
redis
JWT SecretVariable

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

Ziel
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.

Ziel
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.

Ziel
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.

Ziel
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.

Ziel
3104
Standard
3125
Wert
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.

Ziel
COOKIE_DOMAIN

Statistik herunterladen

323,353
Downloads insgesamt

Einzelheiten

Repository
standardnotes/server:latest
Zuletzt aktualisiert2026-04-11
Erstmals gesehen2026-05-13

Führen Sie StandardNotes-Server auf Unraid aus.

StandardNotes-Server ist gelistet in Community Apps für Unraid OS. Erkunden Sie Unraid, um einen flexiblen Heimserver, ein NAS oder ein Heimlabor aufzubauen.