selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Codex logo

Self-host Codex

v2.5.7

Comic archive browser and reader with OPDS support

ReleaseOpen SourceGPL-3.0
Updated9 hours ago
LanguagePython
Setup difficultyModerate
MobileResponsive
Stars
327
RAM
1 GB
Port
9810 (HTTP web server)
Requires
Unrar
Docker
ghcr.io/ajslater/codex
Install with Docker Compose

What is Codex?

Codex is a self-hosted web application for browsing and reading comic archives. It supports multiple formats and automatically imports new files added to your library folders. The interface lets you explore comics by publisher, series, volume, folder structure, or story arcs, with full-text search and flexible filtering. You can edit metadata tags directly in the browser, which writes changes back to the original files, and fetch metadata from online databases with interactive matching. The reader works on any screen size with configurable layouts and reading directions, and remembers your position and preferences per user. Access can be open or require accounts, with private libraries limited to specific groups and optional age gates. For authentication, it offers built-in accounts, OIDC integration with providers like Authentik and Authelia, and reverse-proxy header authentication. It also speaks OPDS 1 and 2 for e-reader apps, logs failed logins for fail2ban, and runs on modest hardware. Licensed under GPLv3, it installs via Docker, Docker Compose, Home Assistant, or a native Python package.

Should you self-host Codex?

Codex scores 54/100 on selfhost.directory (how scoring works) and ranks #5 of 14 in Comics. It has 327 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v2.5.7, came out on 28 October 2026. New versions land roughly every 3 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is clu-comics (52/100, 292 stars). Codex scores higher overall. See Codex vs clu-comics side by side.

Features

  • Age restrictions
  • Comic archive reading
  • Custom covers
  • Fail2ban Integration
  • File Renaming
  • Filesystem watching
  • Full-Text Search
  • Multi-user support
  • OIDC Single Sign-On
  • Online tagging
  • OPDS 1 & 2 syndication
  • Per-user bookmarks and reading settings
  • Remote-User SSO
  • Saved views and searches
  • Tag editingRequires comics directory mounted writable

Codex README

How to install Codex

Install Codex with Docker Compose

Docker Compose

services: codex: image: ghcr.io/ajslater/codex container_name: codex env_file: .env volumes: - /host/path/to/config:/config - /host/path/to/comics:/comics ports: - "9810:9810" restart: on-failure healthcheck: test: [CMD, curl, --fail, "http://localhost:9810/health"] interval: 30s timeout: 10s retries: 3 start_period: 15s

Remove :ro flag from /comics volume for tag editing

Codex releases & version history

More in Comics

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…