Install phpIPAM on Ubuntu 20.04/18.04

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-

  1. On the first page, Select “New phpipam installation“
  2. Since we had created a database, we’ll go with “MySQL import instructions“.
  3. This will output the command to import the SQL file.
    sudo mysql -u root -p phpipam < /var/www/html/phpipam/db/SCHEMA.sql
  4. For Automatic database installation, set like below.
  5. On successful installation, you should get the admin login page.
  6. 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/

Share

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.