powerdns-admin/README.md

# PowerDNS-Admin
A PowerDNS web interface with advanced features.
[![Build Status](https://travis-ci.org/ngoduykhanh/PowerDNS-Admin.svg?branch=master)](https://travis-ci.org/ngoduykhanh/PowerDNS-Admin)

#### Features:
- Multiple domain management
- Domain template
- User management
- User access management based on domain
- User activity logging
- Local DB / LDAP / Active Directory user authentication
- Support SAML authentication
- Google oauth authentication
- Github oauth authentication
- 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!)

### 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 which has PowerDNS-Admin, PowerDNS server and MySQL Back-End Database.

Step 1: Changing configuration
The configuration file for developement environment is located at `configs/development.py`, you can override some configs by editing `.env` file.

Step 2: Build docker images

```$ docker-compose build```

Step 3: Start docker containers

```$ docker-compose up```

You can now access PowerDNS-Admin at url http://localhost:9191

**NOTE:** For other methods to run PowerDNS-Admin, please take look at WIKI pages.

### 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)
![two-factor authentication config](https://cloud.githubusercontent.com/assets/6447444/16111111/467f2226-33db-11e6-926a-01b4d15035d2.png)
Create README.md 2015-12-13 10:46:24 +00:00			`# PowerDNS-Admin`
Update README.md 2018-04-01 09:07:41 +00:00			`A PowerDNS web interface with advanced features.`
Update README.md 2018-04-02 06:45:44 +00:00			`[![Build Status](https://travis-ci.org/ngoduykhanh/PowerDNS-Admin.svg?branch=master)](https://travis-ci.org/ngoduykhanh/PowerDNS-Admin)`
Create README.md 2015-12-13 10:46:24 +00:00
Update README.md 2015-12-13 11:07:10 +00:00			`#### Features:`
Update README.md 2015-12-13 11:07:59 +00:00			`- Multiple domain management`
Update README.md 2018-04-01 09:07:41 +00:00			`- Domain template`
Update README.md 2015-12-13 11:07:10 +00:00			`- User management`
Fix some spelling mistakes in README. Add supported version information. 2016-05-27 06:03:59 +00:00			`- User access management based on domain`
Update README.md 2015-12-13 11:07:10 +00:00			`- User activity logging`
Update README.md 2018-04-01 09:07:41 +00:00			`- Local DB / LDAP / Active Directory user authentication`
Resolve the conflicts for #228 2018-04-02 06:38:53 +00:00			`- Support SAML authentication`
			`- Google oauth authentication`
			`- Github oauth authentication`
Update README.md 2018-04-01 09:07:41 +00:00			`- Support Two-factor authentication (TOTP)`
Update README.md 2015-12-13 11:07:10 +00:00			`- Dashboard and pdns service statistics`
Updated README to mention DynDNS 2 support 2016-06-21 22:22:02 +00:00			`- DynDNS 2 protocol support`
Add 'pretty IPv6 PTR' as a feature. 2016-08-19 23:28:59 +00:00			`- Edit IPv6 PTRs using IPv6 addresses directly (no more editing of literal addresses!)`
Update README.md 2015-12-13 11:07:10 +00:00
Update README.md 2018-04-01 09:07:41 +00:00			`### Running PowerDNS-Admin`
Update README.md 2018-04-18 03:32:10 +00:00			`There are several ways to run PowerDNS-Admin. Following is a simple way to start PowerDNS-Admin with docker in development environment which has PowerDNS-Admin, PowerDNS server and MySQL Back-End Database.`
Create README.md 2015-12-13 10:46:24 +00:00
Editing README 2018-04-18 03:31:00 +00:00			`Step 1: Changing configuration`
Update README.md 2018-04-18 03:34:46 +00:00			The configuration file for developement environment is located at `configs/development.py`, you can override some configs by editing `.env` file.
Update README.md 2018-04-01 09:10:07 +00:00
Editing README 2018-04-18 03:31:00 +00:00			`Step 2: Build docker images`
Update README.md 2018-04-01 09:10:07 +00:00
Editing README 2018-04-18 03:31:00 +00:00			```$ docker-compose build```
Update README.md 2018-04-01 09:10:07 +00:00
Editing README 2018-04-18 03:31:00 +00:00			`Step 3: Start docker containers`
Update README.md 2018-04-01 09:10:07 +00:00
Editing README 2018-04-18 03:31:00 +00:00			```$ docker-compose up```
Create README.md 2015-12-13 10:46:24 +00:00
Update README.md 2018-04-01 09:07:41 +00:00			`You can now access PowerDNS-Admin at url http://localhost:9191`
Create README.md 2015-12-13 10:46:24 +00:00
Editing README 2018-04-18 03:31:00 +00:00			`NOTE: For other methods to run PowerDNS-Admin, please take look at WIKI pages.`
Update README.md 2015-12-13 10:58:26 +00:00
Add screnshots to show new UI. 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)`
Update README for new feature. 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)`
Add screnshots to show new UI. 2016-05-14 01:42:39 +00:00