{"id":24186726,"url":"https://github.com/nasx/phpipam-install","last_synced_at":"2026-06-08T08:01:41.619Z","repository":{"id":155737420,"uuid":"147223700","full_name":"nasx/phpipam-install","owner":"nasx","description":"Ansible Role to Handle Installation of phpIPAM on RHEL 7","archived":false,"fork":false,"pushed_at":"2018-09-04T14:03:45.000Z","size":39,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-13T12:46:52.877Z","etag":null,"topics":["ansible","phpipam","rhel"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nasx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-09-03T15:33:51.000Z","updated_at":"2022-10-28T20:09:23.000Z","dependencies_parsed_at":"2024-03-31T12:45:48.590Z","dependency_job_id":null,"html_url":"https://github.com/nasx/phpipam-install","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasx%2Fphpipam-install","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasx%2Fphpipam-install/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasx%2Fphpipam-install/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasx%2Fphpipam-install/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nasx","download_url":"https://codeload.github.com/nasx/phpipam-install/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241596243,"owners_count":19988041,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","phpipam","rhel"],"created_at":"2025-01-13T12:36:41.177Z","updated_at":"2026-06-08T08:01:36.584Z","avatar_url":"https://github.com/nasx.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# phpIPAM Installer\nWritten to support RHEL 7 and phpIPAM version 1.4.\n## About\nThis Ansible role is designed to do a reference install on RHEL 7 using the RHEL install instructions [1] detailed on the phpIPAM website. It is assumed that SELinux is ENABLED on the installation system and a custom SELinux policy [2] is created to allow subnet discovery.\n## Variables\n| Variable Name | Values | Vault | Description |\n| :--- | :--- | :--- | :--- |\n| mysql_secure_installation | True/False | No | Perform the equivalent of running the mysql_secure_installation command. |\n| setup_selinux_http_ping_policy | True/False | No | Install http_ping custom policy to allow subnet discovery on SELinux enabled systems. |\n| php_timezone | String | No | See php documentation [3] for a list of valid vaules (default is America/New_York). |\n| phpipam_git_url | String | No | Link to the phpIPAM source code (default is https://github.com/phpipam/phpipam.git). |\n| phpipam_database_username | String | Yes | The username phpIPAM will use to connect to the MariaDB database (default is phpipam). |\n| phpipam_database_password | String | Yes | The password phpIPAM will use to connect to the MariaDB database. |\n| phpipam_database_name | String | Yes | The database phpIPAM will use to store application database in the MariaDB database (default is phpipam). |\n| mysql_root_password | String | Yes | The password for the MariaDB root user. The root user is used to bootstrap the phpIPAM phpipam_database_username, associated permissions and create the phpipam_database_name database. |\n## Usage\n### Cloning the Repository\nCreate a directory and clone the git repository as follows:\n```bash\ngit clone https://github.com/nasx/phpipam-install\n```\n### Variables\nThe non-vault variables should be updated in roles/phpIPAM/vars/main.yml to reflect your installation. They can also be overwritten when launching the playbook by assigning them as extra vars (see ansible-playbook man page, specifically --extra-vars or -e).\n\nVault variables should be added to a vault and passed to the command line as extra vars (see above). To create a vault, use the ansible-vault command:\n```bash\nansible-vault create vault\n```\n### Inventory\nThe phpIPAM role is expecting a single host in your inventory file. The contents of the inventory file could be as simple as a single line with a host. This host should be in FQDN format. For example:\n```\nipam.lab.local\n```\n### Running the Playbook\nTo run the playbook we will use the ansible-playbook command to run the install.yml playbook. The install.yml playbook simply runs the phpIPAM role on all hosts marked in the provided inventory file.\n\nThe following example will leverage the root user (-u root) to login to the host defined in your inventory file. It will prompt you for the root password (-k) as well as the vault password (--ask-vault-pass) using the vault we created above (-e @vault). The playbook should run on the host(s) defined in the inventory file simply named inventory (-i inventory).\n```bash\nansible-playbook -u root -k --ask-vault-pass -e @vault -i inventory install.yml\n```\n### Next Steps\nAfter successfully running the playbook you can login to phpIPAM using the default credentials: admin/ipamadmin.\n## External Links\n[1] - https://phpipam.net/news/phpipam-installation-on-centos-7/\u003cbr/\u003e\n[2] - https://phpipam.net/news/selinux-policy-for-icmp-checks/\u003cbr/\u003e\n[3] - http://php.net/manual/en/timezones.php\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasx%2Fphpipam-install","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnasx%2Fphpipam-install","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasx%2Fphpipam-install/lists"}