Installation
Mango runs on any system with Java 17 or higher. Choose the installation method that fits your environment:
| Method | Best for | Guide |
|---|---|---|
| Docker | Production deployments, quick evaluation | Docker Installation |
| Linux | Production servers (Ubuntu, Debian, RHEL) | Linux Installation |
| Windows | Development, on-premise Windows servers | Windows Installation |
| macOS | Local development and testing | macOS Installation |
Before you install
- Check Java requirements — Mango requires Java 17+. See Java Requirements.
- Choose a database — Mango ships with H2 (embedded) for evaluation. For production, use MySQL/MariaDB or PostgreSQL. See Database Configuration.
- Plan your data directory — Mango stores configuration, logs, and file data in a configurable data directory. See Configuration File.
Java Version Compatibility
Mango is currently developed and tested on Java 21 and Java 25. If you use Java 25, note that Chronicle Map will not function due to incompatibilities introduced in that release. Use Java 21 if you rely on Chronicle Map.
After installation
Once Mango is running, open your browser to http://localhost:8080 and log in with the default credentials (admin / admin). Then proceed to First Steps to learn the core concepts.