docker compose incantations to remember.
Downloads
Grab the latest build from the platform’s releases page and pick the file for your platform.Current builds are unsigned. Nothing about the binary is broken — the OS just asks once on first launch. Follow the platform steps below and you’ll only see the prompt once.
Prerequisites
Before you launch the app, make sure the host has:- Docker. Docker Desktop on macOS or Windows, or Docker Engine plus the Compose plugin on Linux. The app shells out to
docker composeon your behalf, so a working Docker install is required. See the Docker download page. - Around 15 GB of free disk — enough for the container images and the Postgres data volume.
- 4 GB of RAM available to Docker. 8 GB is more comfortable if you plan to keep flows running in the background.
First launch
- macOS
- Windows
- Linux
- Open the
.dmgand dragNora.appinto Applications. - Open Applications, right-click on
Nora.app, and choose Open. - macOS shows “macOS cannot verify the developer of Nora”. Click Open.
- On macOS 14 and later, the right-click bypass can still be blocked. If it is:
- Open System Settings → Privacy & Security.
- Scroll to the bottom for “Nora was blocked to protect your Mac” and click Open Anyway.
- When the dialog reappears, click Open.
- From this point on,
Nora.appopens with a normal double-click.
Where things get placed
Once the app is open, it lays out a few things on the host:- The app binary lives at
/Applications/Nora.appon macOS,%LOCALAPPDATA%\Noraon Windows, or wherever you saved the AppImage on Linux. - The Docker stack config lives under
~/.nora/onprem/. On first launch, the app writesdocker-compose.ymland.env.onpremhere (both bundled inside the app). It generates a random Postgres password for you, so you don’t have to edit anything before you click [Install Nora]. - The Docker volumes are
nora-onprem_pgdataandnora-onprem_qdrantdata. They’re normal Docker volumes and show up indocker volume ls. - The container images land in your usual Docker image store on first install.
Next
First launch
Walk through the install wizard, the tray icon, and the SPA handoff.
Settings
License key, host port, reset, and full uninstall.
Updates
Check for updates online, or import an offline update tarball.
Docker Compose
The same compose file, run directly on a server.