https://github.com/codeaffen/phpipam-ansible-modules
Ansible Modules to manage phpIPAM installations
https://github.com/codeaffen/phpipam-ansible-modules
ansible ansible-modules hacktoberfest phpipam phpipam-ansible-modules phpipam-api
Last synced: about 2 months ago
JSON representation
Ansible Modules to manage phpIPAM installations
- Host: GitHub
- URL: https://github.com/codeaffen/phpipam-ansible-modules
- Owner: codeaffen
- License: gpl-3.0
- Created: 2020-08-26T10:49:55.000Z (over 5 years ago)
- Default Branch: develop
- Last Pushed: 2025-08-16T18:43:45.000Z (7 months ago)
- Last Synced: 2025-08-16T20:36:40.531Z (7 months ago)
- Topics: ansible, ansible-modules, hacktoberfest, phpipam, phpipam-ansible-modules, phpipam-api
- Language: Python
- Homepage: https://codeaffen.org/projects/phpipam-ansible-modules
- Size: 339 KB
- Stars: 24
- Watchers: 3
- Forks: 14
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.rst
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# phpIPAM Ansible Modules
[](https://galaxy.ansible.com/ui/repo/published/codeaffen/phpipam/)
[](https://www.codacy.com/gh/codeaffen/phpipam-ansible-modules/dashboard?utm_source=github.com&utm_medium=referral&utm_content=codeaffen/phpipam-ansible-modules&utm_campaign=Badge_Grade)
[](https://phpipam-ansible-modules.readthedocs.io/en/develop/?badge=develop)
This collection provides modules to manage entities in a [phpIPAM](https://phpipam.net/). This is neither a collection of roles nor playbooks. It provides modules to write your own roles and/or playbooks.
We get a lot of inspiration from [foreman-ansible-modules](https://galaxy.ansible.com/theforeman/foreman) for our modules.
## Installation
The collection is available via [Ansible Galaxy](https://galaxy.ansible.com/ui/repo/published/codeaffen/phpipam/). So you can run
```bash
ansible-galaxy collection install codeaffen.phpipam
```
Alternatively you can build and install the collection from source.
```bash
make dist
ansible-galaxy collection install codeaffen-phpipam-.tar.gz
```
## Documentation
### readthedocs.io
Current documentation can be found on [readthedocs.io](https://phpipam-ansible-modules.readthedocs.io/en/develop/).
### ansible-doc
If you have installed the collection you can facilitate `ansible-doc` to display documentation for a given module.
```bash
ansible-doc codeaffen.phpipam.section
```
### repository folder
A last option to read the docs is the docs folder in this repository.
## Dependencies
The following dependencies have to be fulfiled by the Ansible controller.
* colour
* geopy
* inflection
* ipaddress
* phpypam>=1.0.0
## Compatibility notice
To ensure `phpipam-ansible-modules` work correctly with phpIPAM versions 1.7 and above, you need to modify the phpIPAM configuration to stringify API results. This is crucial because newer phpIPAM versions might return numerical values directly, which the Ansible modules might expect as strings.
Here's how to implement the workaround:
**1. Modify phpIPAM Configuration**
You need to set the `api_stringify_results` variable to `true` in your phpIPAM configuration. This change should be made in the `config.php` file, which is typically located in the phpIPAM installation directory (e.g., `/var/www/html/phpipam/config.php` or `/var/www/phpipam/config.php`).
Add or modify the following line in your `config.php` file:
```
```
## Need help?
If you’ve found any issues in this release please head over to github and open a bug so we can take a look.