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.

happypandax logo

Self-host happypandax

v0.13.3

Manga/doujinshi manager with server and web client

AlphaOpen SourceLGPL-3.0
Updated8 hours ago
LanguageJavaScript
Setup difficultyModerate
MobileResponsive
Stars
821
Ports
7006 (torrent client), 7007 (server API), 7008 (web client), 7009 (Redis (built-in)), 7010 (Elasticsearch (built-in)), 7011 (Elasticsearch transport (built-in))
Docker
twiddly/happypandax
Install with Docker
HappyPanda X web client library viewHappyPanda X web client gallery viewHappyPanda X web client reader view

What is happypandax?

A cross-platform manga and doujinshi management system with a server backend and built-in web client. It organizes libraries with collections, groups, and tags, fetches metadata automatically via plugins, downloads from supported sites, and reads common archive formats. Runs via Docker, Docker Compose, or native binaries on Windows, macOS, and Linux. Uses SQLite by default with optional PostgreSQL. Still in alpha; user permissions are incomplete.

Should you self-host happypandax?

happypandax scores 51/100 on selfhost.directory (how scoring works) and ranks #6 of 14 in Comics. It has 821 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

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

Its closest alternative on selfhost.directory is Kavita (73/100, 11 960 stars). It scores higher overall, so compare the two before you pick. See happypandax vs Kavita side by side.

Features

  • Advanced search with regex
  • Archive Format Support
  • Automatic metadata fetching
  • Auto-update
  • Backup system
  • Built-in web client
  • Download Management
  • Internationalization (I18N)
  • Manga/doujinshi library management
  • Multiple Database Backends
  • Plugin System
  • Reverse Proxy Support
  • TLS/SSL Support
  • User and permission managementNot fully implemented yet per documentation

happypandax README

How to install happypandax

Install happypandax with Docker

Environment variables
HPX_PORT, HPX_WEBPORT, HPX_TORRENTPORT, HPX_DATA, HPX_CONTENT, RUN_IN_BACKGROUND, AUTOSTART_ON_BOOT

HPX_PORT=7007 HPX_WEBPORT=7008 HPX_TORRENTPORT=7006 HPX_DATA="/path/to/desired/hpx/datadir" HPX_CONTENT="/path/to/desired/hpx/contentdir" RUN_IN_BACKGROUND=true AUTOSTART_ON_BOOT=always docker run -p $HPX_PORT:7007 -p $HPX_WEBPORT:7008 -p $HPX_TORRENTPORT:7006 --name happypandax --restart AUTOSTART_ON_BOOT --volume=$HPX_DATA:/data --volume=$HPX_CONTENT:/content -d=$RUN_IN_BACKGROUND twiddly/happypandax

Linux & Mac OS. For Windows use cmd.exe syntax with set commands.

happypandax releases & version history

FAQ

How does the gallery scanner work with directory structures?

The scanner uses special tokens like {collection}, {grouping}/{series}, {artist}, {gallery} in paths to identify metadata. Supports regex and glob patterns for flexible matching of various directory structures.

What file formats does HappyPanda X support?

Supports ZIP, RAR, CBR, CBZ, TAR.GZ, TAR.BZ2, TAR.XZ archives and JPG, JPEG, BMP, PNG, GIF images, plus folders with loose files. Additional formats can be added via plugins.

More in Comics

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…