cwinfo/powerdns-admin
5
0
Fork 0
mirror of https://github.com/cwinfo/powerdns-admin.git synced 2024-12-04 19:15:30 +00:00
Code Issues Packages Projects Releases Wiki Activity
A PowerDNS web interface with advanced features
1,667 Commits 1 Branch 6 Tags 36 MiB
Python 50.5%
HTML 44.5%
JavaScript 3.4%
CSS 0.9%
Dockerfile 0.4%
Other 0.2%
08c39c64c2
Go to file
Tyler Todd 08c39c64c2
Fix non rr_set events in Zone Changelog display 
This will resolve #1566
2023-06-22 12:03:42 -04:00
.github Updated the application version references in preparation for the next release of 0.4.2. 2023-04-14 19:33:32 -04:00
configs Overhauled app settings implementation to remove redundancy of definitions. Additionally, re-factored settings initialization code to allow for every setting to be defined by environment variable for both bare metal and Docker container deployments. 2023-04-14 07:12:02 -04:00
deploy Create setup_win.bat 2022-12-15 12:54:31 +08:00
docker Improve things for using PostgreSQL 2023-03-12 13:11:20 +01:00
docker-test Improve things for using PostgreSQL 2023-03-12 13:11:20 +01:00
docs Updating documentation to reflect the latest app settings changes. 2023-04-14 19:38:54 -04:00
migrations fix(db:migrate): fix migration user 'confirmed' column migration 2023-03-14 21:16:50 +00:00
powerdnsadmin Fix non rr_set events in Zone Changelog display 2023-06-22 12:03:42 -04:00
tests Update tests fix 2022-12-22 22:47:02 +01:00
.dockerignore Update docker stuff and bug fixes 2019-12-04 11:50:46 +07:00
.gitattributes Add .gitattributes 2018-06-11 17:12:52 +07:00
.gitignore Added default CAPTCHA settings to default configuration. 2023-02-18 19:18:59 -05:00
.lgtm.yml Add .lgtm.yml 2018-08-31 21:58:11 +07:00
.whitesource Add .whitesource configuration file 2020-08-31 20:52:34 +00:00
.yarnrc Update docker stuff and bug fixes 2019-12-04 11:50:46 +07:00
docker-compose-test.yml Update tests fix 2022-12-22 22:47:02 +01:00
docker-compose.yml Merge pull request #1212 from corubba/feature/privacy-first 2023-01-24 05:34:30 -05:00
LICENSE Updated project README to include a refreshed feature list. 2023-02-26 03:47:28 -05:00
package.json Added jQuery Validation 1.19.5 to the project NPM configuration as well as the Flask assets build script for js_main. 2023-04-10 13:06:06 -04:00
README.md Updating documentation to reflect the latest app settings changes. 2023-04-14 19:38:54 -04:00
requirements.txt Update Versions 2023-06-22 10:24:59 -04:00
run.py Corrected dependency conflicts with the recently merged requirements.txt file. 2023-02-17 18:32:36 -05:00
SECURITY.md Relocated new security policy to the project root to meet GitHub feature expectations. 2023-03-17 16:46:34 -04:00
update_accounts.py Domains should not be updated in update_accounts.py 2020-08-06 15:40:11 +02:00
update_zones.py Change domain(s) to zone(s) in the python code and docs 2023-03-16 17:02:23 +01:00
VERSION Updated the application version references in preparation for the next release of 0.4.2. 2023-04-14 19:33:32 -04:00
yarn.lock Added jQuery Validation 1.19.5 to the project NPM configuration as well as the Flask assets build script for js_main. 2023-04-10 13:06:06 -04:00

README.md

PowerDNS-Admin

A PowerDNS web interface with advanced features.

CodeQL Docker Image

Features:

  • Provides forward and reverse zone management
  • Provides zone templating features
  • Provides user management with role based access control
  • Provides zone specific access control
  • Provides activity logging
  • Authentication:
    • Local User Support
    • SAML Support
    • LDAP Support: OpenLDAP / Active Directory
    • OAuth Support: Google / GitHub / Azure / OpenID
  • Two-factor authentication support (TOTP)
  • PDNS Service Configuration & Statistics Monitoring
  • DynDNS 2 protocol support
  • Easy IPv6 PTR record editing
  • Provides an API for zone and record management among other features
  • Provides full IDN/Punycode support

Running PowerDNS-Admin

There are several ways to run PowerDNS-Admin. The quickest way is to use Docker. If you are looking to install and run PowerDNS-Admin directly onto your system, check out the wiki for ways to do that.

Docker

Here are two options to run PowerDNS-Admin using Docker. To get started as quickly as possible, try option 1. If you want to make modifications to the configuration option 2 may be cleaner.

Option 1: From Docker Hub

To run the application using the latest stable release on Docker Hub, run the following command:

$ docker run -d \
    -e SECRET_KEY='a-very-secret-key' \
    -v pda-data:/data \
    -p 9191:80 \
    powerdnsadmin/pda-legacy:latest

This creates a volume named pda-data to persist the default SQLite database with app configuration.

Option 2: Using docker-compose

  1. Update the configuration
    Edit the docker-compose.yml file to update the database connection string in SQLALCHEMY_DATABASE_URI. Other environment variables are mentioned in the AppSettings.defaults dictionary. To use a Docker-style secrets convention, one may append _FILE to the environment variables with a path to a file containing the intended value of the variable (e.g. SQLALCHEMY_DATABASE_URI_FILE=/run/secrets/db_uri).
    Make sure to set the environment variable SECRET_KEY to a long, random string (https://flask.palletsprojects.com/en/1.1.x/config/#SECRET_KEY)

  2. Start docker container

    $ docker-compose up

You can then access PowerDNS-Admin by pointing your browser to http://localhost:9191.

Screenshots

dashboard

Support

Looking for help? Try taking a look at the project's Support Guide or joining our Discord Server.

Security Policy

Please see our Security Policy.

Contributing

Please see our Contribution Guide.

Code of Conduct

Please see our Code of Conduct Policy.

License

This project is released under the MIT license. For additional information, see the full license.

Donate

Like my work?

Buy Me A Coffee

Want to sponsor me? Please visit my organization's sponsorship page.