Deploy and Host Andromeda - Bookmarks on Railway

Andromeda - Bookmarks is a self-hosted personal link saver written in Go, organizing saved links by category. It serves a public list, an admin panel with cookie sessions, favicon fetching, and a JSON API with API-key-gated writes — all backed by a single SQLite database.

About Hosting Andromeda - Bookmarks

Hosting Andromeda - Bookmarks means running a single Go binary that serves the public link list and admin interface over HTTP. State lives in a SQLite file, so deployment needs only a persistent volume plus environment variables (admin password, API key, port). Writes via POST /api/links are gated by an API key, enabling automation from other tools. 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 bookmark manager organized by category
• A public "links" page for a blog or portfolio
• Programmatically saving links via POST /api/links from scripts or extensions

Dependencies for Andromeda - Bookmarks Hosting

• A persistent volume for the SQLite database
• An API key for authenticated link creation via the API

Deployment Dependencies

• Andromeda repository
• Releases page

Implementation Details

Environment variables (see .env.example):

BOOKMARKS_PASSWORD=changeme   # admin panel password
BOOKMARKS_API_KEY=            # gates POST /api/links
BOOKMARKS_DB_PATH=/data/bookmarks.sqlite
HOST=0.0.0.0
PORT=3000
COOKIE_SECURE=true            # set true behind HTTPS

Mount a Railway volume so BOOKMARKS_DB_PATH persists. Set HOST=0.0.0.0 and COOKIE_SECURE=true in production.

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