The objective of this guide is to help you Install and Configure phpIPAM on Ubuntu 20.04/18.04 Linux distribution. phpIPAM is an open-source php-based web IP address management application (IPAM). Its goal is to provide light, modern and useful IP address management. phpIPAM uses MySQL database backend and jQuery libraries, Ajax and HTML5/CSS3 features.
Install phpIPAM on Ubuntu 20.04/18.04
phpIPAM has a number of dependencies that we need to install before we can install and configure phpIPAM. These are:
- MySQL / MariaDB server
- php / php-fpm for nginx
- php modules
- Apache / nginx web server
- phpIPAM domain – ipam.example.com (should be replaced with your domain)
Step 1: Install MariaDB Server
Start with the installation of MariaDB database server:
sudo apt update sudo apt install mariadb-server mariadb-client
Ensure mariadb service is started and set to start at boot:
sudo systemctl enable mariadb sudo systemctl start mariadb
Secure database server by setting root password:
sudo mysql_secure_installation
Once the database installation and setup is complete, create a database for phpipam user:
$ sudo mysql -u root -p CREATE DATABASE phpipam; GRANT ALL ON phpipam.* TO phpipam@localhost IDENTIFIED BY 'StrongDBPassword'; FLUSH PRIVILEGES; QUIT;
Step 2: Install PHP and required modules
Next phase is the installation of php and required modules. Run the following commands:
sudo apt update sudo apt -y install php php-{mysql,curl,gd,intl,pear,imap,memcache,pspell,tidy,xmlrpc,mbstring,gmp,json,xml,fpm}
Step 3: Install phpIPAM on Ubuntu 20.04/18.04 Linux
We’ll download phpIPAM from Github. Install git first:
sudo apt -y install git
Clone phpIPAM code from github
sudo git clone --recursive https://github.com/phpipam/phpipam.git /var/www/html/phpipam
Change to clone directory.
cd /var/www/html/phpipam
You can also download phpipam from official Sourceforge repository and extract it to your web server directory.
Step 4: Configure phpIPAM on Ubuntu 20.04/18.04
Change your working directory to /var/www/html/phpipam and copy config.dist.php to config.php, then edit it.
sudo cp config.dist.php config.php
Edit the file to configure database credentials as added on Step 1:
$ sudo vim config.php /** * database connection details ******************************/ $db['host'] = 'localhost'; $db['user'] = 'phpipam'; $db['pass'] = 'StrongDBPassword'; $db['name'] = 'phpipam'; $db['port'] = 3306;
Install Using Apache Web Server
If you would like to use Apache web server, first install it using:
sudo systemctl stop nginx && sudo systemctl disable nginx sudo apt -y install apache2 sudo a2dissite 000-default.conf sudo a2enmod rewrite sudo systemctl restart apache2
Install apache php module:
sudo apt -y install libapache2-mod-php php-curl php-xmlrpc php-intl php-gd
Add Apache phpipam configuration:
sudo vim /etc/apache2/sites-available/phpipam.conf
<VirtualHost *:80> ServerAdmin admin@example.com DocumentRoot "/var/www/html/phpipam" ServerName ipam.example.com ServerAlias www.ipam.example.com <Directory "/var/www/html/phpipam"> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> ErrorLog "/var/log/apache2/phpipam-error_log" CustomLog "/var/log/apache2/phpipam-access_log" combined </VirtualHost>
Enable site:
sudo a2ensite phpipam
Restart Apache server for changes to be made.
sudo systemctl restart apache2
Step 5: Finish phpIPAM Installation on Ubuntu 20.04/18.04
Start the installation process by visiting http://ipam.example.com, replace ipam.example.com with your valid domain name. The URL could also be http://domain.com/phpipam or IP Address instead of DNS name depending on your configuration.
http://ipam.example.com
Now follow on screen installation wizard-
- On the first page, Select “New phpipam installation“
- Since we had created a database, we’ll go with “MySQL import instructions“.
- This will output the command to import the SQL file.
sudo mysql -u root -p phpipam < /var/www/html/phpipam/db/SCHEMA.sql
- For Automatic database installation, set like below.
- On successful installation, you should get the admin login page.
- The default Login credentials are:
Username: admin
Password: ipamadmin
You’re prompted to change the admin password on the first login.
You have successfully installed phpIPAM on Ubuntu 20.04 / Ubuntu 18.04 Linux system.
Src: https://computingforgeeks.com/install-and-configure-phpipam-on-ubuntu-debian-linux/