powerdns-admin/README.md

71 lines
2.6 KiB
Markdown
Raw Normal View History

2015-12-13 10:46:24 +00:00
# PowerDNS-Admin
2018-04-01 09:07:41 +00:00
A PowerDNS web interface with advanced features.
2015-12-13 10:46:24 +00:00
2015-12-13 11:07:10 +00:00
#### Features:
2015-12-13 11:07:59 +00:00
- Multiple domain management
2018-04-01 09:07:41 +00:00
- Domain template
2015-12-13 11:07:10 +00:00
- User management
- User access management based on domain
2015-12-13 11:07:10 +00:00
- User activity logging
2018-04-01 09:07:41 +00:00
- Local DB / LDAP / Active Directory user authentication
- Support Two-factor authentication (TOTP)
2015-12-13 11:07:10 +00:00
- Dashboard and pdns service statistics
- DynDNS 2 protocol support
2016-08-19 23:28:59 +00:00
- Edit IPv6 PTRs using IPv6 addresses directly (no more editing of literal addresses!)
2015-12-13 11:07:10 +00:00
2015-12-13 10:46:24 +00:00
## Setup
### PowerDNS Version Support:
PowerDNS-Admin supports PowerDNS autoritative server versions **3.4.2** and higher.
2015-12-13 10:46:24 +00:00
### pdns Service
2018-04-01 09:07:41 +00:00
I assume that you have already installed pdns service. Make sure that your `pdns.conf` config file has these contents
PowerDNS 4.0.0 and later
```
api=yes
api-key=your-powerdns-api-key
webserver=yes
```
PowerDNS before 4.0.0
2015-12-13 10:46:24 +00:00
```
experimental-json-interface=yes
experimental-api-key=your-powerdns-api-key
webserver=yes
```
2018-04-01 09:07:41 +00:00
This will enable API access in pdns service so PowerDNS-Admin can intergrate with it.
2015-12-13 10:46:24 +00:00
### Create Database
We will create a database which used by this web application. Please note that this database is difference from pdns database itself.
2018-04-01 09:07:41 +00:00
PowerDNS-Admin supports MySQL server, Maria DB, PostgresQL and SQL Lite.
2015-12-13 10:46:24 +00:00
```
MariaDB [(none)]> CREATE DATABASE powerdnsadmin;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON powerdnsadmin.* TO powerdnsadmin@'%' IDENTIFIED BY 'your-password';
2015-12-13 10:46:24 +00:00
```
2018-04-01 09:07:41 +00:00
### Running PowerDNS-Admin
There are several ways to run PowerDNS-Admin. Following is a simple way to start PowerDNS-Admin with docker in development environment.
2015-12-13 10:46:24 +00:00
2018-04-01 09:07:41 +00:00
Firstly, let's edit `configs/developments.py` configuration file.
Secondly, build the docker image of PowerDNS-Admin
` $docker-compose -f docker-compose.dev.yml build`
Finally, start it
`$ docker-compose -f docker-compose.dev.yml up`
2015-12-13 10:46:24 +00:00
2018-04-01 09:07:41 +00:00
You can now access PowerDNS-Admin at url http://localhost:9191
2015-12-13 10:46:24 +00:00
2018-04-01 09:07:41 +00:00
NOTE: For other methods to run PowerDNS-Admin, please take look at WIKI pages.
2015-12-13 10:58:26 +00:00
2016-05-14 01:42:39 +00:00
### Screenshots
![login page](https://github.com/ngoduykhanh/PowerDNS-Admin/wiki/images/readme_screenshots/fullscreen-login.png?raw=true)
![dashboard](https://github.com/ngoduykhanh/PowerDNS-Admin/wiki/images/readme_screenshots/fullscreen-dashboard.png?raw=true)
![create domain page](https://github.com/ngoduykhanh/PowerDNS-Admin/wiki/images/readme_screenshots/fullscreen-domaincreate.png?raw=true)
![manage domain page](https://github.com/ngoduykhanh/PowerDNS-Admin/wiki/images/readme_screenshots/fullscreen-domainmanage.png?raw=true)
2016-06-16 09:02:34 +00:00
![two-factor authentication config](https://cloud.githubusercontent.com/assets/6447444/16111111/467f2226-33db-11e6-926a-01b4d15035d2.png)
2016-05-14 01:42:39 +00:00