Deploy and Host Andromeda - Library on Railway

Andromeda - Library is a self-hosted personal book tracker written in Go. Search titles through Google Books, add them to your collection, and browse your library through a web UI and JSON API, all backed by a single SQLite database.

About Hosting Andromeda - Library

Hosting Andromeda - Library means running a single Go binary that serves the public library and admin interface over HTTP. State lives in a SQLite file, so deployment needs only a persistent volume plus environment variables (admin password, base URL, port). Book search proxies to the Google Books API; an API key is optional but raises rate limits. 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 reading list and book collection tracker
A public "what I'm reading" page for a blog or portfolio
Cataloging a small shared or household library

Dependencies for Andromeda - Library Hosting

A persistent volume for the SQLite database
(Optional) Google Books API key for higher search rate limits

Deployment Dependencies

Implementation Details

Environment variables (see .env.example):

ADMIN_PASSWORD=changeme
LIBRARY_DB_PATH=/data/library.sqlite
GOOGLE_BOOKS_API_KEY=         # optional
BASE_URL=https://your-app.up.railway.app
HOST=0.0.0.0
PORT=3000
COOKIE_SECURE=true            # set true behind HTTPS
LIBRARY_DISPLAY_MODE=inline   # inline or nav

Mount a Railway volume so LIBRARY_DB_PATH persists. Set HOST=0.0.0.0, COOKIE_SECURE=true, and BASE_URL to your public URL.

Why Deploy Andromeda - Library 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 - Library 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.