# How to Install phpIPAM on Arch Linux

> URL: https://www.atlantic.net/dedicated-server-hosting/how-to-install-phpipam-on-arch-linux/ | Published: 2023-04-24 | Updated: 2023-11-17 | Author: Hitesh Jethva

phpIPAM is a free, open-source, lightweight, and modern IP address monitoring tool for system and network administrators. It uses MySQL as a database system and is written in PHP, jQuery libraries, Ajax, and HTML5/CSS3. phpIPAM gives you a real-time inventory of used and unassigned IP addresses with other details like subnets, status, hostname, and more.

This post will show you how to install phpIPAM with Nginx on Arch Linux.

## Step 1 – Configure Repository

By default, the default repository is outdated in Arch Linux, so you will need to modify the default mirror list. You can do it by editing the mirror list configuration file:

```
nano  /etc/pacman.d/mirrorlist
```

Remove all lines and add the following lines:

```
## Score: 0.7, United States
Server = http://mirror.us.leaseweb.net/archlinux/$repo/os/$arch
## Score: 0.8, United States
Server = http://lug.mtu.edu/archlinux/$repo/os/$arch
Server = http://mirror.nl.leaseweb.net/archlinux/$repo/os/$arch
## Score: 0.9, United Kingdom
Server = http://mirror.bytemark.co.uk/archlinux/$repo/os/$arch
## Score: 1.5, United Kingdom
Server = http://mirrors.manchester.m247.com/arch-linux/$repo/os/$arch
Server = http://archlinux.dcc.fc.up.pt/$repo/os/$arch
## Score: 6.6, United States
Server = http://mirror.cs.pitt.edu/archlinux/$repo/os/$arch
## Score: 6.7, United States
Server = http://mirrors.acm.wpi.edu/archlinux/$repo/os/$arch
## Score: 6.8, United States
Server = http://ftp.osuosl.org/pub/archlinux/$repo/os/$arch
## Score: 7.1, India
Server = http://mirror.cse.iitk.ac.in/archlinux/$repo/os/$arch
## Score: 10.1, United States
Server = http://mirrors.xmission.com/archlinux/$repo/os/$arch
```

Save and close the file, then update all the package indexes with the following command:

```
pacman -Syu
```

## Step 2 – Install Nginx

The Nginx package is included in the Arch Linux default repository by default. You can install it with the following command.

```
pacman -S nginx-mainline
```

After installing Nginx, start and enable the Nginx service using the following command.

```
systemctl start nginx
systemctl enable nginx
```

## Step 3 – Install and Configure PHP

phpIPAM is a PHP-based application, so you must install PHP and other extensions to your server. You can install all of them using the following command.

```
pacman -S php php-fpm php-gd unzip
```

Next, you must install the Pear PHP extension to your system. You can download and install it with the following command.

```
wget http://pear.php.net/go-pear.phar
php go-pear.phar
```

Next, edit the PHP configuration file and enable all the required PHP extensions.

```
nano /etc/php.ini
```

Add/modify the following lines.

```
extension=pdo_mysql
extension=gd
extension=json
extension=mysqli
extension=intl
extension=xml
extension=bcmath
extension=gmp
extension=iconv
extension=gettext
extension=sockets
```

Save and close the file, then start the PHP-FPM service and enable it to start at system reboot.

```
systemctl start php-fpm
systemctl enable php-fpm
```

## Step 4 – Install and Configure MariaDB Database

Next, you will need to install the MariaDB database on your system. You can install it with the following command.

```
pacman -S mariadb
```

Once the MariaDB server is installed, initialize the MariaDB database with the following command.

```
mysql_install_db --user=mysql --basedir=/usr --datadir=/var/lib/mysql
```

Next, start and enable the MariaDB service using the following command.

```
systemctl start mysqld
systemctl enable mysqld
```

Next, connect to the MariaDB shell:

```
mysql
```

Next, create a database and user for phpIPAM using the following command.

```
CREATE DATABASE phpipam;
GRANT ALL ON phpipam.* TO phpipam@localhost IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
```

Next, exit from the MariaDB with the following command.

```
QUIT;
```

## Step 5 – Install phpIPAM

First, download the latest version of phpIPAM to the Nginx root directory.

```
mkdir /var/www/html
git clone --recursive https://github.com/phpipam/phpipam.git /var/www/html/phpipam
```

Next, navigate to the phpipam directory and copy the sample configuration file.

```
cd /var/www/html/phpipam
cp config.dist.php config.php
```

Next, edit the configuration file.

```
nano config.php
```

Add the following line:

```
$allow_untested_php_versions=true;
```

Define your database settings:

```
/**
* database connection details
******************************/
$db['host'] = 'localhost';
$db['user'] = 'phpipam';
$db['pass'] = 'password';
$db['name'] = 'phpipam';
$db['port'] = 3306;
```

Save and close the file, then import the phpIPAM database.

```
cd /var/www/html/phpipam
mysql -u root -p phpipam < db/SCHEMA.sql
```

Next, change the ownership of the phpipam directory.

```
chown -R http:http /var/www/html/phpipam
```

## Step 6 – Configure Nginx for phpIPAM

Next, you must create an Nginx virtual host configuration file to serve phpIPAM.

First, create a directory to store the Nginx virtual host.

```
mkdir /etc/nginx/sites-enabled
```

Next, create an Nginx configuration file for phpIPAM.

```
nano /etc/nginx/sites-enabled/phpipam.conf
```

Add the following configuration.

```
server {
    listen       80;
    # root directory
    server_name ipam.example.com;
    index        index.php;
    root   /var/www/html/phpipam;


    location / {
            try_files $uri $uri/ /index.php$is_args$args;
        }

    location ~ \.php$ {
            try_files $uri =404;
            fastcgi_split_path_info ^(.+\.php)(/.+)$;
             fastcgi_pass   unix:/run/php-fpm/php-fpm.sock;
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            fastcgi_index index.php;
            include fastcgi_params;
        }

 }
```

Save the file, then edit the Nginx main configuration file.

```
nano /etc/nginx/nginx.conf
```

Add the following lines after http{:

```
server_names_hash_bucket_size 64;
include sites-enabled/*;
```

Save the file when you are done. Then, verify the Nginx configuration.

```
nginx -t
```

You will see the following output.

```
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
```

Next, restart the Nginx service to implement the changes.

```
systemctl restart nginx
```

## Step 7 – Access phpIPAM Web UI

Now, open your web browser and access the phpIPAM web interface using the URL **http://ipam.example.com.** You should see the phpIPAM welcome screen.

![](https://www.atlantic.net/wp-content/uploads/2023/04/p1-2.png)

Click on the **New phpipam** installation. You should see the following screen.

![](https://www.atlantic.net/wp-content/uploads/2023/04/p2-2.png)

Click on the **MySQL/MariaDB import instructions.** You should see the following screen.

![](https://www.atlantic.net/wp-content/uploads/2023/04/p3-1.png)

Provide your phpIPAM database details and click on the **install phpipam** database. You should see the following screen.

![](https://www.atlantic.net/wp-content/uploads/2023/04/p4-1.png)

Click on the **Login.** You should see your phpIPAM login screen.

![](https://www.atlantic.net/wp-content/uploads/2023/04/p6-1.png)

Provide phpIPAM admin username **admin** and password as **ipamadmin**, then click the **Login** button. You should see the change password screen.

![](https://www.atlantic.net/wp-content/uploads/2023/04/p8-2.png)

Change your default password and click on the **Save password.** Then, click on the **Dashboard** button. You should see the following screen.

![](https://www.atlantic.net/wp-content/uploads/2023/04/p9-1.png)

## Conclusion

Congratulations! You have successfully installed the phpIPAM password management tool on Arch Linux. You can now easily install phpIPAM on your server and test it. You can also try to deploy phpIPAM on [dedicated server hosting](https://www.atlantic.net/dedicated-server-hosting/) from Atlantic.Net!