StandardNotes-LocalStack
StandardNotes-LocalStack
OfficialDocker app from junkerderprovinz Repository
Overview
LocalStack companion for the Standard Notes self-hosted backend.
Provides the SNS and SQS endpoints the standardnotes/server image
expects at "localstack:4566".
Required side container. Without it, files-worker.log fills with
"SQSError: SQS receive message failed: getaddrinfo ENOTFOUND
localstack" and notes can duplicate.
Hostname resolution. The server resolves the literal name
"localstack". Pick one:
User-defined Docker network: put both containers on the same
custom bridge and set this container's network alias to
"localstack". Docker's embedded DNS handles the rest.
br0 / macvlan / VLAN / static-IP install: assign this container
a fixed IP on the same VLAN as StandardNotes-Server, then
append --add-host=localstack:LocalStack-IP to
StandardNotes-Server's Extra Parameters and restart it.
Verify from the Unraid host:
docker exec StandardNotes-Server getent hosts localstack
Must print a non-empty line.
Required init script. LocalStack starts empty. The server expects a
fixed set of SNS topics and SQS queues. The "LocalStack Bootstrap
Script" path mapping below mounts the bootstrap script into
/etc/localstack/init/ready.d/ where LocalStack runs it on ready.
Automatic bootstrap on container start runs ONLY when ALL THREE
of the following are true at first start:
a) the host file /mnt/user/appdata/standardnotes/localstack_bootstrap.sh
exists,
b) it is executable (chmod +x),
c) the "LocalStack Bootstrap Script" Path mapping is left at its
default (mapped to /etc/localstack/init/ready.d/localstack_bootstrap.sh).
LocalStack's init/ready.d/ hook fires ONCE per container lifetime.
If the script was missing on first start, restart the container or
use the README emergency-bootstrap one-liner to populate it in place.
Before first start, on the Unraid host:
mkdir -p /mnt/user/appdata/standardnotes
curl -fsSL -o /mnt/user/appdata/standardnotes/localstack_bootstrap.sh \
https://raw.githubusercontent.com/junkerderprovinz/standardnotes-server/main/scripts/localstack_bootstrap.sh
chmod +x /mnt/user/appdata/standardnotes/localstack_bootstrap.sh
Verify after start:
docker exec StandardNotes-LocalStack awslocal \
--endpoint-url=http://localhost:4566 sqs list-queues
docker exec StandardNotes-LocalStack awslocal \
--endpoint-url=http://localhost:4566 sns list-topics
Both must list the *-local-queue / *-local-topic entries.
Runtime arguments
- Network
bridge- Shell
sh- Privileged
- false
- Extra Params
--restart=unless-stopped --hostname=localstack
Template configuration
LocalStack Edge PortPorttcp
Edge port for SNS / SQS. Reachable from the server container on the same network. Publishing to the host is optional.
- Target
- 4566
- Default
- 4566
- Value
- 4566
Services (SERVICES)Variable
Required services. Keep sns,sqs.
- Target
- SERVICES
- Default
- sns,sqs
- Value
- sns,sqs
External Hostname (HOSTNAME_EXTERNAL)Variable
Keep localstack. Server resolves this name.
- Target
- HOSTNAME_EXTERNAL
- Default
- localstack
- Value
- localstack
Log Level (LS_LOG)Variable
Log level. Default warn.
- Target
- LS_LOG
- Default
- warn
- Value
- warn
LocalStack Bootstrap ScriptPathro
Required bootstrap script. Creates Standard Notes SNS topics and SQS queues. See Overview for the curl + chmod host-prep commands.
- Target
- /etc/localstack/init/ready.d/localstack_bootstrap.sh
- Default
- /mnt/user/appdata/standardnotes/localstack_bootstrap.sh
- Value
- /mnt/user/appdata/standardnotes/localstack_bootstrap.sh
Categories
Download Statistics
482,725,619
Total Downloads
Details
Repository
localstack/localstack:3.0Last Updated2026-05-28
First Seen2026-05-13
Run StandardNotes-LocalStack on Unraid.
StandardNotes-LocalStack is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.