Build from source when you deploy a fork, a custom patch, or a build pinned to an exact revision. If you want to work on the Memos codebase itself, start with the Development section instead — this page only covers turning a source build into a deployment.

Produce a release build

Follow Setup for the toolchain, then Building for the build commands. A release build embeds the frontend assets into a single binary, so the result deploys exactly like a downloaded release.

For deployments, always build from a tagged or pinned revision rather than main:

git clone https://github.com/usememos/memos.git
cd memos
git checkout v0.29.1  # pin the version you intend to run

Run the result as a deployment

The self-built binary behaves like the official release binary. Memos listens on http://localhost:8081 by default.

Follow the Binary guide for the production concerns:

process supervision (systemd or similar)
data directory ownership and permissions
reverse proxy and HTTPS

Before production use

set explicit environment variables for instance URL and database
run a smoke test against the new binary before switching traffic
keep a backup before deploying a new build — see Backup & Restore

Build From Source

Produce a release build

Run the result as a deployment

Before production use

On this page