Deploy to Fly.io

Serverless deployment with persistent SQLite volumes.

Prerequisites

  • Fly CLI installed and authenticated
  • flyctl version 0.2.0 or higher

Setup

1. Create App

fly apps create mnemosyne-api

2. Create Volume

fly volumes create mnemosyne_data --size 10 --region ord

3. fly.toml

app = "mnemosyne-api"
primary_region = "ord"

[build]
dockerfile = "Dockerfile"

[mounts]
source = "mnemosyne_data"
destination = "/data"

[env]
MNEMOSYNE_DB_PATH = "/data/mnemosyne.db"
MNEMOSYNE_HOST = "0.0.0.0"
MNEMOSYNE_PORT = "8080"

[http_service]
internal_port = 8080
force_https = true
auto_stop_machines = true
auto_start_machines = true
min_machines_running = 0

4. Dockerfile

FROM python:3.12-slim

WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt

COPY . .
EXPOSE 8080

CMD ["python", "-m", "mnemosyne.server"]

5. Deploy

fly deploy

Scaling

# Scale to 2 machines
fly scale count 2

# Scale memory
fly scale memory 512

Monitoring

# Logs
fly logs

# Status
fly status

# Metrics
fly metrics
Fly.io Limits

Fly.io free tier includes 3GB persistent volumes and 256MB RAM. For production workloads, scale to paid instances with 512MB+ RAM.

Related Pages

Deployment Overview
Overview of Mnemosyne deployment options: Docker, Fly.io, systemd services, and cron jobs. Choose th...
Docker Deployment
Run Mnemosyne in Docker: official images, Docker Compose setup, volume mounting for persistent stora...
Monitoring
Set up monitoring for Mnemosyne: health endpoints, Prometheus metrics, memory usage stats, query lat...