Mango v0.2.5

Mango is a self-hosted manga server and web reader
  • v0.2.5 - April 2, 2020
  • v0.2.4 - April 2, 2020
  • v0.2.3 - March 27, 2020
  • v0.2.2 - March 19, 2020
  • v0.2.1 - March 15, 2020



Patreon Build Gitter

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

  • Multi-user support
  • Dark/light mode switch
  • Supports both .zip and .cbz formats
  • Supports nested folders in library
  • Automatically stores reading progress
  • Built-in MangaDex downloader
  • 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


Pre-built Binary

  1. 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 docker-compose.example.yml to docker-compose.yml
  4. Modify the volumes in docker-compose.yml to point the directories to desired locations on the host machine
  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 to log in

Build from source

  1. Make sure you have Crystal, Node and Yarn installed. You might also need to install the development headers for libsqlite3 and libyaml.
  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 e-manga server/reader. Version 0.2.0

    -v, --version                    Show version
    -h, --help                       Show help
    -c PATH, --config=PATH           Path to the config file. Default is `~/.config/mango/config.yml`


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
library_path: ~/mango/library
db_path: ~/mango/mango.db
scan_interval_minutes: 5
log_level: info
  download_wait_seconds: 5
  download_retries: 4
  download_queue_db_path: ~/mango/queue.db
  • scan_interval_minutes can be any non-negative integer. Setting it to 0 disables the periodic scan
  • log_level can be debug, info, warn, error, fatal or off. Setting it to off disables the logging

Library Structure

You can organize your .cbz/.zip 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


github statistic
  • 129
  • 0
  • 9
  • 6
  • 1 day ago
  • February 11, 2020

MIT License

Synced at

Fri, 03 Apr 2020 09:38:57 GMT