Deploy and Host Andromeda - Jotts on Railway

Andromeda - Jotts is a self-hosted minimal markdown notes app written in Go. The jotts server mode serves a password-protected web UI plus an optional JSON API; the same binary also ships a Bubble Tea TUI editor and a CLI uploader. Notes are stored in a single SQLite database.

About Hosting Andromeda - Jotts

Hosting Andromeda - Jotts means running jotts server, a single Go binary that serves the web UI and JSON API over HTTP. State lives in a SQLite file, so deployment needs only a persistent volume plus environment variables (login password, port, optional API key). Markdown renders server-side with goldmark; all templates and assets are embedded, and the build is pure-Go SQLite (no CGO). On Railway, the included Dockerfile builds the image, a persistent volume holds the database, and environment variables configure the rest. No external database service is required.

Common Use Cases

• A personal, self-hosted markdown notes app accessible from anywhere
• A backend the jotts CLI/TUI syncs notes to from a developer's terminal
• A headless notes store consumed via the x-api-key-gated JSON API

Dependencies for Andromeda - Jotts Hosting

• A persistent volume for the SQLite database
• (Optional) An API key to enable the JSON API at /api/notes

Deployment Dependencies

• Andromeda repository
• Releases page

Implementation Details

Run jotts server as the start command. Environment variables (see .env.example):

JOTTS_PASSWORD=changeme
JOTTS_DB_PATH=/data/jotts.sqlite
COOKIE_SECURE=true            # set true behind HTTPS
HOST=0.0.0.0
PORT=3000
JOTTS_API_KEY=                # set to enable JSON API; unset = API returns 403

Mount a Railway volume so JOTTS_DB_PATH persists. Set HOST=0.0.0.0 and COOKIE_SECURE=true in production. The JSON API requires an x-api-key: $JOTTS_API_KEY header.

Why Deploy Andromeda - Jotts on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Andromeda - Jotts on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.