Skip to content
nostos
Product Pricing Journal Docs Self-host
Sign in Get started
Product Pricing Journal Docs Self-host FAQ Sign in Get started

Run it yourself.

Nostos is free software under the AGPLv3. The version you run at home is the same Nostos as Nostos Cloud, with no account and no subscription.

One Compose file

Save this as compose.yml:

services:
  nostos:
    image: ghcr.io/christian-gennari/nostos:latest
    ports:
      - "5099:8080"
    volumes:
      - nostos-data:/data
    restart: unless-stopped

volumes:
  nostos-data:

Start it with docker compose up -d, then open http://localhost:5099. From another machine on your network, use the server’s address instead of localhost.

The /data volume holds everything: the database, your books and audiobooks, local backups, and the keys for anything you save in Settings. Keep it on a local disk.

What it runs on

The image is published for amd64 and arm64, 64-bit only, so it runs on a home server, a NAS, a Raspberry Pi with a 64-bit OS, or an Apple Silicon Mac with Docker. It includes everything it needs, FFmpeg too.

Give it at least 512 MB of memory; 1 GB is comfortable. Nostos uses about 110 MB when idle and about 320 MB at its peak with 50 EPUBs and 5 audiobooks. Disk space grows with your books and audiobooks.

Where to go next

  • Quickstart and requirements in the documentation
  • The full documentation, for reverse proxies, backups and updates
  • The source on GitHub

Rather not run a server? Nostos Cloud is the same Nostos, kept running and backed up for you, and your library can move between the two.

nostos

A home for the books you read, the thoughts they leave, and the writing that follows. Created by Christian Gennari.

Navigation

  • Library
  • Studio
  • Brain
  • Reading
  • Ownership
  • Pricing
  • FAQ

Project

  • View source
  • Self-host
  • Documentation
  • Journal
  • Feedback
  • AGPLv3 License
  • Trademark Policy
Nostos and the arch doorway mark are trademarks of Christian Gennari.
Open source copyleft under AGPLv3.
Privacy Terms Report content