mirror of https://github.com/cwinfo/powerdns-admin.git synced 2024-12-27 21:45:39 +00:00

A PowerDNS web interface with advanced features

Go to file

steschuser 07c71fb0bf setting account_user_ids to empty list on GET /account/edit (#966 )		2021-08-05 19:41:28 +02:00
.github	Create stale.yml	2020-10-12 22:50:39 +02:00
configs	SAML improvements for Docker (#929 )	2021-05-07 23:36:55 +02:00
docker	Allow user role to view history (#890 )	2021-03-27 19:33:11 +01:00
docker-test	Fix #592 - Adjustment in Dockerfile to upgrade pip package	2019-12-07 14:45:41 +07:00
docs	Resolve the conflicts and add adjustment to #591	2019-12-06 14:27:35 +07:00
migrations	Allow user role to view history (#890 )	2021-03-27 19:33:11 +01:00
powerdnsadmin	setting account_user_ids to empty list on GET /account/edit (#966 )	2021-08-05 19:41:28 +02:00
tests	Extend api with account and user management	2020-01-27 14:04:15 +00: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	Update gitignore	2020-05-17 13:40:24 +07:00
.lgtm.yml	Add .lgtm.yml	2018-08-31 21:58:11 +07:00
.travis.yml	Add Api to PowerDNS-Admin	2019-03-01 23:50:04 +01: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	Fix the tests	2019-12-06 10:59:19 +07:00
docker-compose.yml	Offline installation and searchable inputs	2020-04-30 17:20:37 +00:00
LICENSE	Change license information	2018-04-02 14:01:35 +07:00
package.json	Offline installation and searchable inputs	2020-04-30 17:20:37 +00:00
README.md	Emphasize importance of using a custom SECRET_KEY (#931 )	2021-05-07 23:40:54 +02:00
requirements.txt	Bump pyyaml from 5.3.1 to 5.4 (#912 )	2021-03-27 19:33:49 +01:00
run.py	Refactoring the code	2019-12-02 10:32:03 +07:00
swagger-specv2.yaml	upd: improve user api (#878 )	2021-03-16 19:39:53 +01:00
update_accounts.py	Domains should not be updated in update_accounts.py	2020-08-06 15:40:11 +02:00
update_zones.py	Implement account update method	2020-08-06 15:22:28 +02:00
yarn.lock	Bump elliptic from 6.5.3 to 6.5.4 (#896 )	2021-03-16 19:41:46 +01:00

README.md

PowerDNS-Admin

A PowerDNS web interface with advanced features.

Features:

Multiple domain management
Domain template
User management
User access management based on domain
User activity logging
Support Local DB / SAML / LDAP / Active Directory user authentication
Support Google / Github / Azure / OpenID OAuth
Support Two-factor authentication (TOTP)
Dashboard and pdns service statistics
DynDNS 2 protocol support
Edit IPv6 PTRs using IPv6 addresses directly (no more editing of literal addresses!)
Limited API for manipulating zones and records
Full IDN/Punycode support

Running PowerDNS-Admin

There are several ways to run PowerDNS-Admin. The easiest 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

This 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

The easiest is to just run the latest Docker image from Docker Hub:

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

This creates a volume called pda-data to persist the SQLite database with the configuration.

Option 2: Using docker-compose

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 legal_envvars. To use the Docker secrets feature it is possible to append _FILE to the environment variables and point to a file with the values stored in it.
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)
Start docker container
```
$ docker-compose up
```

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