mirror of https://github.com/cwinfo/powerdns-admin.git synced 2024-12-27 05:25:40 +00:00

A PowerDNS web interface with advanced features

Go to file

Dominic Zöller 6f12b783a8 models.user: get_accounts(): order by name The order of account names returned by User.get_accounts() affects the order account names are displyed in on /domain/add if the current user neither has the Administrator role nor the Operator role and the `allow_user_create_domain` setting is enabled at the same time. If the current user does have the Administrator or Operator role, routes.domain.add() already returns accounts ordered by name, so this change makes it consistent.		2021-12-04 16:09:15 +01:00
.github	Update docker image build script	2021-11-06 15:44:20 +01:00
configs	default config: add exemplary URL encoding step for SQLA DB URL params	2021-11-30 22:29:00 +01:00
docker	Remove unnecessary build step (#1003 )	2021-10-30 21:29:23 +02:00
docker-test	Fix #592 - Adjustment in Dockerfile to upgrade pip package	2019-12-07 14:45:41 +07:00
docs	feat: Associate an API Key with accounts (#1044 )	2021-12-03 14:12:11 +00:00
migrations	feat: Associate an API Key with accounts (#1044 )	2021-12-03 14:12:11 +00:00
powerdnsadmin	models.user: get_accounts(): order by name	2021-12-04 16:09:15 +01: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
.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	Datepicker replace (#1059 )	2021-12-02 11:59:36 +01:00
README.md	Update README.md	2021-10-31 13:16:42 +01:00
requirements.txt	fix: jsmin 2.2.2 no longer available. Use 3.0.0 (#1021 )	2021-10-30 21:30:53 +02:00
run.py	Refactoring the code	2019-12-02 10:32:03 +07: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.