Hydrodactyl

Hydrodactyl is a modern, performance-focused game server management panel forked from Pterodactyl. It delivers smaller bundles, faster builds, and an accessible, reimagined interface.

Features

• Reimagined client panel — a redesigned interface for console, files, databases, backups, network, users, startup, schedules, activity, and software.
• Marketplace — a native plugin and mod installer for Minecraft servers backed by Modrinth, Hangar, and Spiget.
• Setup wizard — guided first-run configuration for new installations.
• Logo customization — custom branding for your panel from the admin dashboard.
• S3-compatible backups — per-node backup storage with any S3-compatible provider.
• PostgreSQL support — run the panel on MySQL, MariaDB, or PostgreSQL.
• OpenAPI documentation — API reference powered by Scalar.
• Modern stack — Laravel 13, React 19, TypeScript, and Tailwind CSS, formatted and linted with Biome.

Warning

Pre-release Software: Hydrodactyl is currently under active development. Some UI elements may appear broken and bugs may exist.

Incompatibility Notice: Hydrodactyl is an all-in-one panel and is not compatible with Blueprint framework extensions.

Note

Please review the official documentation at hydrodactyl.dev before installing.

Built by the maintainer of the original Pyrodactyl project and funded by Blueprint.

Quick start

git clone https://github.com/BlueprintFramework/hydrodactyl.git
cd hydrodactyl
cp .env.example .env
cp docker-compose.example.yml docker-compose.yml
docker compose up -d

See the Installation Guide and Local Development Guide for detailed instructions.

Note

Windows is supported for local development only.

License

Hydrodactyl is open-source software licensed under the Apache License 2.0.

You are free to use, modify, and redistribute Hydrodactyl under the terms of the license. A copy of the full license text is available in the LICENSE file included in this repository.

Copyright & Attribution

Hydrodactyl is built upon the work of previous open-source projects and their contributors:

• Pterodactyl®: Copyright © 2015–2022 Dane Everitt and contributors.
• Pyrodactyl™: Copyright © 2023–2025 Pyro Inc. and contributors.
• Pyrodactyl™: Copyright © 2025–2026 Pyrodactyl-oss and contributors.
• Hydrodactyl: Copyright © 2026–present Naterfute, Blueprint Framework, and contributors.

All original copyright notices, license notices, and attributions must remain intact when redistributing this software.

Unless explicitly stated otherwise, all source code within this repository is licensed under the Apache License 2.0.

Support

Help Hydrodactyl grow by supporting the project:

• Donate on Ko-fi: Support the maintainer.
• Donate to Blueprint Framework: Support the nonprofit funding Hydrodactyl.
• Join the Discord: Chat with the community and get support.
• Star the repository: Share it with others to help more people discover Hydrodactyl.