Deploy Andromeda - Quotes
A minimal quote management app
stevedylandev/andromeda/apps/quotes
Just deployed
/data
Deploy and Host Andromeda - Quotes on Railway
Andromeda - Quotes is a self-hosted, minimal quote-a-day site written in Go. The landing page shows a single deterministic "quote of the day" — white, centered, on a dark background — while a password-protected /admin panel adds, searches, and removes quotes. An open JSON read API and a CSV seed command round it out. Data lives in a single SQLite file.
About Hosting Andromeda - Quotes
Hosting Andromeda - Quotes means running one Go binary that serves the public page, the admin panel, and the JSON API over HTTP. All templates, static assets, and the classic-author seed list are embedded, and the build is pure-Go SQLite (no CGO), so deployment needs only a persistent volume plus a few environment variables (admin password, port, optional API key). The quote of the day is computed deterministically and rotates at UTC midnight. On Railway, the included Dockerfile builds the image, a persistent volume holds the SQLite database, and environment variables configure the rest. No external database service is required. A fresh deploy starts empty — add quotes from /admin or seed the volume from the bundled quotes.csv.
Common Use Cases
- A personal, self-hosted "quote of the day" page for a homepage or dashboard
- A curated classic-literature quote collection, seeded once and managed from the browser
- A headless quote source consumed via the open JSON API (
/api/quotes,/api/quotes/today)
Dependencies for Andromeda - Quotes Hosting
- A persistent volume for the SQLite database
- (Optional) The bundled
quotes.csvfor one-off classic-literature seeding
Deployment Dependencies
Implementation Details
Environment variables (see .env.example):
QUOTES_PASSWORD=changeme # admin login; empty disables login
QUOTES_DB_PATH=/data/quotes.sqlite
COOKIE_SECURE=true # set true behind HTTPS
HOST=0.0.0.0
PORT=3000
QUOTES_API_KEY= # reserved; the read API is currently open
Mount a Railway volume so QUOTES_DB_PATH persists. Set HOST=0.0.0.0 and COOKIE_SECURE=true in production.
The database starts empty. Seed it with the bundled classic-literature CSV (matched against the embedded author list in classic_authors.txt) by running the seed command once against the mounted volume:
quotes seed /path/to/quotes.csv
Re-seeding is idempotent, and the same binary serves the site with the default start command quotes.
Why Deploy Andromeda - Quotes 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 - Quotes 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.
Template Content
stevedylandev/andromeda/apps/quotes
ghcr.io/stevedylandev/andromeda/apps/quotesQUOTES_PASSWORD
Admin password to manage quotes
