Data Directory

Data Directory

All persistent data is stored in a single directory. Mount it as a Docker volume to preserve data across container updates.

Directory Layout

data/
├── codexa.db       # SQLite database (WAL mode)
├── books/          # Uploaded EPUB files
├── covers/         # Extracted cover images
├── fonts/          # User-uploaded custom fonts
└── dictionaries/   # StarDict dictionary files (.ifo / .idx / .dict)

Docker Volume Example

In your docker-compose.yaml:

volumes:
  - ./data:/data

And set the environment variable:

environment:
  DATA_DIR: /data

The database schema is migrated automatically on startup — no manual migration steps are needed.