Mango-Go

A self-hosted manga server and web reader written in Go

Features

• Manga Library Management - Organize and browse your collection
• Web Reader - Read manga directly in your browser
• Responsive Design - Works on desktop, tablet, and mobile
• Download Manager - Download manga from various sources
• Tagging System - Organize with custom tags and folders
• Multi-User Support - User management with permission levels
• Subscriptions - Track and download new chapters automatically
• Progress Tracking - Keep track of your reading progress

Quick Start

Docker (Recommended)

1. Create docker-compose.yml:

   services:
     mango:
       image: ghcr.io/vrsandeep/mango-go
       container_name: mango
       restart: unless-stopped
       ports:
         - "8080:8080"
       environment:
         - MANGO_DATABASE_PATH=/app/data/mango.db
         - MANGO_LIBRARY_PATH=/manga
         - MANGO_PLUGINS_PATH=/app/plugins
       volumes:
         - ./data:/app/data
         - ./manga:/manga
         - ./plugins:/app/plugins

2. Start:

   docker-compose up -d

3. Get admin password:

   docker-compose logs | grep "Password:"

4. Access: http://localhost:8080

Binary

Download from Releases or build with make build. Create config.yml (see config.yml) and run ./mango-go.

Library Organization

Organize manga with series at the root level:

manga/
├── One Piece/
│   ├── Volume 1/
│   │   ├── Chapter 1.cbr
│   │   └── Chapter 2.cbr
│   └── Volume 2/
└── Naruto/
    ├── Volume 1.cbz
    └── Volume 2.cbz

Supported formats: .cbz, .cbr, .cb7, .zip, .rar, .7z

Configuration

Variable	Description	Default
MANGO_LIBRARY_PATH	Path to manga library	./manga
MANGO_DATABASE_PATH	SQLite database path	./mango.db
MANGO_PLUGINS_PATH	Path to plugins directory	../mango-go-plugins
MANGO_PORT	Web server port	8080
MANGO_SCAN_INTERVAL	Library scan interval (minutes)	30

Screenshots

Troubleshooting

• Library Not Scanning: Check file permissions and ensure the manga directory is accessible
• Port Already in Use: Change the port in your configuration

View logs:

# Docker
docker-compose logs

# Standalone
./mango-go 2>&1 | tee mango.log

Documentation

• Issues: GitHub Issues
• Contributing: CONTRIBUTING.md
• Plugins: PLUGIN_SYSTEM_DESIGN.md

Acknowledgments

Original Mango project for inspiration