https://github.com/lamgc/poweradmin-docker
Deploy PowerAdmin in Docker!
https://github.com/lamgc/poweradmin-docker
docker-image powerdns powerdns-admin
Last synced: 4 months ago
JSON representation
Deploy PowerAdmin in Docker!
- Host: GitHub
- URL: https://github.com/lamgc/poweradmin-docker
- Owner: LamGC
- License: apache-2.0
- Created: 2024-11-27T17:21:35.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-03-10T00:21:28.000Z (7 months ago)
- Last Synced: 2025-03-10T01:32:21.852Z (7 months ago)
- Topics: docker-image, powerdns, powerdns-admin
- Language: Shell
- Homepage: https://hub.docker.com/r/lamgc/poweradmin
- Size: 52.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# poweradmin-docker
English | [中文](./README.zh.md)
# Warning, this is an unofficial image!!!
Official repository: [poweradmin/poweradmin](https://github.com/poweradmin/poweradmin)
Repository URL for this image: [LamGC/poweradmin-docker](https://github.com/LamGC/poweradmin-docker)
For issues related to PowerAdmin, you should create issue at [poweradmin/poweradmin](https://github.com/poweradmin/poweradmin).
If it's a Docker deployment issue, you can create issue at [LamGC/poweradmin-docker](https://github.com/LamGC/poweradmin-docker).
## Usage
### Using Docker Compose
A simple PowerAdmin configuration is as follows, you should add container configurations for MySQL
or other supported databases as needed, as well as container configurations for PowerDNS auth.
> If you want a complete configuration, you can take a look at the [example](example/) directory, which contains a basic Docker Compose configuration for PowerDNS + PowerAdmin + MySQL.
```yaml
services:
pdns-admin:
image: lamgc/poweradmin:latest
container_name: powerdns_admin
ports:
- "9191:80"
logging:
driver: json-file
options:
max-size: 50m
volumes:
# When you encounter the issue of being unable to save the installation configuration during installation,
# please write the content to this host path, and remove the annotation for the mapping in the following line.
# - "./pdns_admin_config/config.inc.php:/var/www/html/inc/config.inc.php"
environment:
# When you have completed all the installation steps of PowerAdmin,
# please uncomment this environment variable below to request the removal of the install directory.
# POWERADMIN_SKIP_INSTALL: true
```
After starting with this configuration, follow PowerAdmin's instructions to complete the installation program,
and then add the `POWERADMIN_SKIP_INSTALL: true` environment variable,
After rebuilding the Docker Compose container group, the container will delete the install directory of PowerAdmin.
### Using `docker run` command
If you don't want to use Docker Compose, you can use this command:
```bash
$ docker run -d --name pdns_admin --restart unless-stopped -v /path/to/pdns_admin_conf:/etc/poweradmin/ -p 9191:80 lamgc/poweradmin:latest
```
> Note: Replace `/path/to/pdns_admin_conf` with the path of an empty directory!
After starting with this configuration, follow the instructions provided by PowerAdmin to complete the installation process.
Then, navigate to the `/path/to/pdns_admin_conf` directory, Execute the command `touch skip_install` to create an empty file named `skip_install`,
and then restart the PowerAdmin container to delete the install directory.
# About image updates
The image will check for the latest version of PowerAdmin daily and automatically build the image.
## License
This project [lamgc/poweradmin](https://github.com/LamGC/poweradmin-docker) is open-sourced under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).
```plaintext
Copyright 2024 lamgc
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at:
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```
> I hope this project can save Docker users time in deploying PowerAdmin! Enjoy~