---
title: "Deploy Andromeda - Jotts"
description: "A minimal markdown note taking app written in Rust"
category: "Other"
url: https://railway.com/deploy/andromeda-jotts
---

# Deploy Andromeda - Jotts

A minimal markdown note taking app written in Rust

**[Deploy Andromeda - Jotts on Railway](https://railway.com/template/andromeda-jotts)**

- **Creator:** Steve Simkins's Projects
- **Category:** Other

## Template content

### jotts https://assets.andromeda.build/jotts-icon.png

- **Image:** ghcr.io/stevedylandev/andromeda/jotts
- **Public domain:** Yes

## Documentation

# 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](https://github.com/stevedylandev/andromeda)
- [Releases page](https://github.com/stevedylandev/andromeda/releases?q=jotts%2F)

### Implementation Details 

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

```bash
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.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — [Jul'26] Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/andromeda-jotts