.gitignore | ||
build.sh | ||
Dockerfile | ||
entrypoint.sh | ||
example-docker-compose.yml | ||
LICENSE | ||
php.ini | ||
README.md |
phpipam-agent
phpIPAM is an open-source web IP address management application. Its goal is to provide light and simple IP address management application.
phpIPAM is developed and maintained by Miha Petkovsek, released under the GPL v3 license, project source is here
Learn more on phpIPAM homepage
This container can be used as a discovery scan agent.
How to use this Docker image
Setup PHPIPAM
-
Configure a remote agent (Administration > scan agents), get the key.
-
For each subnet, enable scan & configure the remote agent by selecting a remote.
Scheduled scans
For scheduled scans these commands are added to the cron script.
1/15 * * * * /usr/local/bin/php /opt/phpipam-agent/index.php update
1/15 * * * * /usr/local/bin/php /opt/phpipam-agent/index.php discover
Run this container
version: '2'
services:
phpipam-agent:
container_name: phpipam-agent
restart: unless-stopped
image: mc303/phpipam-agent:latest
environment:
- MYSQL_ENV_MYSQL_HOST=10.10.1.10
- MYSQL_ENV_MYSQL_DATABASE=phpipam
- MYSQL_ENV_MYSQL_USER=phpipam
- MYSQL_ENV_MYSQL_PASSWORD=phpipam
- MYSQL_ENV_MYSQL_PORT=3307
- PHPIPAM_AGENT_KEY=abcder1223456xczxcsad
- CRON_SCHEDULE=1/15 * * * *
- TZ=Europe/Amsterdam
ports:
- "3306:3306"
Now, the update/discovery scans will be performed every X minute defined by CRON_SCHEDULE environment variable.
The logs are available on stdout/stderr (allowing to use docker logs
).
Acknowledgements
Based on pierrecdn/phpipam-agent, published on docker hub.