| .devcontainer | ||
| .github | ||
| .phan | ||
| addons | ||
| assets | ||
| config | ||
| data | ||
| install | ||
| lib | ||
| locale | ||
| playwright | ||
| sql | ||
| templates | ||
| tests | ||
| vendor | ||
| .dockerignore | ||
| .gitattributes | ||
| .gitignore | ||
| .hadolint.yaml | ||
| .htaccess | ||
| .php-cs-fixer.php | ||
| .release-please-manifest.json | ||
| caddy.conf.example | ||
| cliff.toml | ||
| composer.json | ||
| composer.lock | ||
| CONTRIBUTING.md | ||
| docker-entrypoint.sh | ||
| DOCKER-SECRETS.md | ||
| DOCKER.md | ||
| Dockerfile | ||
| dynamic_update.php | ||
| favicon.ico | ||
| index.php | ||
| LICENSE | ||
| nginx.conf.example | ||
| package.json | ||
| phpcs.xml | ||
| phpdoc.dist.xml | ||
| phpmd.xml | ||
| phpstan.neon | ||
| phpunit.xml.dist | ||
| playwright.config.js | ||
| psalm-baseline.xml | ||
| psalm.xml | ||
| README.md | ||
| release-please-config.json | ||
| renovate.json | ||
| robots.txt | ||
| transifex.yml | ||
Poweradmin
Poweradmin is a friendly web-based DNS administration tool for PowerDNS server. The interface supports most of the features of PowerDNS. It is a hybrid solution that uses SQL for most operations and has PowerDNS API support for DNSSEC operations.
Features
- Supports all zone types (master, native, and slave)
- Supermasters for automatic provisioning of slave zones
- Zone templates for quick zone creation
- Bulk operations for records and reverse DNS
- IPv6 support
- Multi-language support (15+ languages)
- DNSSEC operations via PowerDNS API
- Light and dark themes
- Search functionality across zones and records
- User and permission management with role-based access
- Ability to add reverse records
- Authentication options:
- Local database authentication
- LDAP authentication with custom filter
- SAML and OIDC authentication
- Multi-factor authentication (MFA/2FA) with TOTP
- RESTful API with OpenAPI documentation (used by Terraform/OpenTofu provider)
- Docker deployment with FrankenPHP
Screenshots
Login Screen
Dashboard
Zone Management
Zone Editor
Installation
For detailed installation instructions, please visit the official documentation.
Traditional Installation
- Recommended method - via releases:
- Get the latest stable release from releases
- For specific needs - via Git:
- Warning: The master branch is used for development and may be unstable. For production use, stick with the stable release/4.x branch or use the
stableDocker tag.
- Warning: The master branch is used for development and may be unstable. For production use, stick with the stable release/4.x branch or use the
Docker Deployment
Quick Start with Docker:
docker run -d \
--name poweradmin \
-p 8080:80 \
-e DB_TYPE=sqlite \
-e PA_CREATE_ADMIN=1 \
poweradmin/poweradmin:latest
Important:
- DB_TYPE environment variable is required (sqlite, mysql, pgsql)
- No admin user is created by default for security reasons. Use
-e PA_CREATE_ADMIN=1to create an admin user (a secure password will be auto-generated and shown in logs)
- Docker Hub:
poweradmin/poweradmin - GitHub Container Registry:
ghcr.io/poweradmin/poweradmin - Full documentation: DOCKER.md
- Security with Docker Secrets: DOCKER-SECRETS.md
Features: Multi-database support (SQLite, MySQL, PostgreSQL), Docker secrets integration, FrankenPHP for enhanced performance.
Requirements
- PHP 8.1 or higher (including 8.2, 8.3, 8.4, etc.)
- PHP extensions: intl, gettext, openssl, filter, tokenizer, pdo, xml, pdo-mysql/pdo-pgsql/pdo-sqlite, ldap (optional)
- MySQL 5.7.x/8.x, MariaDB, PostgreSQL or SQLite database
- PowerDNS authoritative server 4.0.0+ (including 4.x and 5.x series)
Tested on
Officially tested versions:
- master (development): PHP 8.2.29, PowerDNS 4.9.5, MariaDB 10.11.15, PostgreSQL 16.3, SQLite 3.51.1
- release/4.x (stable): PHP 8.1.31, PowerDNS 4.7.4, MariaDB 10.11.10, MySQL 9.1.0, PostgreSQL 16.3, SQLite 3.45.3
- release/3.x (LTS): PHP 8.1.31, PowerDNS 4.7.4, MariaDB 10.11.10, MySQL 9.1.0, PostgreSQL 16.3, SQLite 3.45.3
User-reported compatibility:
- PowerDNS 4.8.x, 4.9.x, and 5.0.x series have been reported to work correctly by community users
Compatibility note: Poweradmin operates primarily at the database level with PowerDNS, using the PowerDNS API only for DNSSEC operations. This design provides broad compatibility across PowerDNS versions, as the database schema remains relatively stable between releases.
Contributing
We welcome contributions to Poweradmin! As the sole maintainer of this non-profit project, I work alongside our amazing contributors. See CONTRIBUTING.md for guidelines.
Support the Project
Poweradmin is independently developed and maintained. Your support helps keep the project alive and growing.
JetBrains provides IDE licenses used for development of this project.
Organizations Supporting Development
- HLkomm Telekommunikations GmbH
- IRAM (Institut de Radioastronomie Millimétrique)
Individual Donors
- Stefano Rizzetto
- Asher Manangan
- Michiel Visser
- Gino Cremer
- Arthur Mayer
- Dylan Blanqué
- trendymail
For feature sponsorship, to speed up development of specific features, or to discuss ideas and issues, please contact me.
Related Projects
- terraform-provider-poweradmin - Terraform/OpenTofu provider for managing DNS zones and records through Poweradmin
- certbot-dns-poweradmin - Certbot DNS plugin for Poweradmin to automate Let's Encrypt certificate issuance with DNS-01 challenge
- external-dns-poweradmin-webhook - ExternalDNS webhook provider for Poweradmin to synchronize Kubernetes DNS records
Note
Poweradmin is an independent community project, not affiliated with PowerDNS.com or Open-Xchange.
License
This project is licensed under the GNU General Public License v3.0. See the LICENSE file for more details.