Mango is a self-hosted manga server and web reader manga-reader self-hosted manga manga-server web-application mangadex
0.26.2 released
1669 113 72
Alex Ling



Patreon Build Gitter Discord

Mango is a self-hosted manga server and reader. Its features include

  • Multi-user support
  • OPDS support
  • Dark/light mode switch
  • Supported formats: .cbz, .zip, .cbr and .rar
  • Supports nested folders in library
  • Automatically stores reading progress
  • Thumbnail generation
  • Supports plugins to download from third-party sites
  • The web reader is responsive and works well on mobile, so there is no need for a mobile app
  • All the static files are embedded in the binary, so the deployment process is easy and painless

Please check the Wiki for more information.


Pre-built Binary

Simply download the pre-built binary file mango for the latest release. All the dependencies are statically linked, and it should work with most Linux systems on amd64.


  1. Make sure you have docker installed and running. You will also need docker-compose
  2. Clone the repository
  3. Copy the env.example file to .env
  4. Fill out the values in the .env file. Note that the main and config directories will be created if they don't already exist. The files in these folders will be owned by the root user
  5. Run docker-compose up. This should build the docker image and start the container with Mango running inside
  6. Head over to localhost:9000 (or a different port if you changed it) to log in

Docker (via Dockerhub)

The official docker images are available on Dockerhub.

Build from source

  1. Make sure you have crystal, shards and yarn installed. You might also need to install the development headers of some libraries. Please see the Dockerfile for the full list of dependencies
  2. Clone the repository
  3. make && sudo make install
  4. Start Mango by running the command mango
  5. Head over to localhost:9000 to log in



  Mango - Manga Server and Web Reader. Version 0.26.2


    mango [sub_command] [options]


    -c PATH, --config=PATH           Path to the config file [type:String]
    -h, --help                       Show this help.
    -v, --version                    Show version.

  Sub Commands:

    admin   Run admin tools


The default config file location is ~/.config/mango/config.yml. It might be different if you are running Mango in a docker container. The config options and default values are given below

port: 9000
base_url: /
session_secret: mango-session-secret
library_path: ~/mango/library
db_path: ~/mango/mango.db
queue_db_path: ~/mango/queue.db
scan_interval_minutes: 5
thumbnail_generation_interval_hours: 24
log_level: info
upload_path: ~/mango/uploads
plugin_path: ~/mango/plugins
download_timeout_seconds: 30
library_cache_path: ~/mango/library.yml.gz
cache_enabled: true
cache_size_mbs: 50
cache_log_enabled: true
disable_login: false
default_username: ""
auth_proxy_header_name: ""
plugin_update_interval_hours: 24
  • scan_interval_minutes, thumbnail_generation_interval_hours, and plugin_update_interval_hours can be any non-negative integer. Setting them to 0 disables the periodic tasks
  • log_level can be debug, info, warn, error, fatal or off. Setting it to off disables the logging
  • You can disable authentication by setting disable_login to true. Note that default_username must be set to an existing username for this to work.
  • By setting cache_enabled to true, you can enable an experimental feature where Mango caches library metadata to improve page load time. You can further fine-tune the feature with cache_size_mbs and cache_log_enabled.

Library Structure

You can organize your archive files in nested folders in the library directory. Here's an example:

├── Manga 1
│   ├── Volume 1.cbz
│   ├── Volume 2.cbz
│   ├── Volume 3.cbz
│   └── Volume
└── Manga 2
    └── Vol. 1
        └── Ch.1 - Ch.3

Initial Login

On the first run, Mango would log the default username and a randomly generated password to STDOUT. You are advised to immediately change the password.



library screenshot


title screenshot

Dark mode:

dark mode screeshot


reader screenshot

Mobile UI:

mobile screenshot



Please check the development guideline if you are interested in code contributions.

Alex Ling

💻 📖 🚇


💻 🤔 🎨






📖 🤔









David Knaack


i use arch btw





  github: hkalexling/Mango
  version: ~> 0.26.2
License MIT
Crystal 1.0.0


Dependencies 15

Development Dependencies 0

Dependents 0

Last synced .
search fire star recently