How to Install ARRCON on NixOS Latest

ARRCON is an open-source project on GitHub that provides an easy-to-use, web-based interface to manage and monitor your applications running on a Nginx server. This tutorial will guide you through the process of installing ARRCON on NixOS Latest.

Prerequisites

Before you begin, you need to have the following:

Step 1: Clone the ARRCON Repository:

First, you need to clone the ARRCON repository to your NixOS machine. Use the following command to do this:

$ sudo git clone https://github.com/radj307/ARRCON.git /var/www/arrcon

Step 2: Install Nginx and PHP:

ARRCON requires Nginx web server and PHP to function. Use the following command to install these packages:

$ sudo nix-env -i -A nixos.nginx nixos.php

Step 3: Configure Nginx:

Create a new Nginx server block for ARRCON configuration. Use the following command to create a configuration file:

$ sudo nano /etc/nginx/sites-available/arrcon.conf

Add the following configuration to the file:

server {
    
    listen 80;

    server_name example.com; # Change this to your domain name
    root /var/www/arrcon;
    index index.php;

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

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/run/php-fpm/php-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_script_name;
    }
}

Save and close the file.

Step 4: Enable the ARRCON Virtual Host:

Create a symbolic link to the newly created server block in the Nginx configuration directory to enable the ARRCON virtual host:

$ sudo ln -s /etc/nginx/sites-available/arrcon.conf /etc/nginx/sites-enabled/arrcon.conf

Restart Nginx to apply the changes:

$ sudo systemctl restart nginx

Step 5: Configure PHP:

Add the following configuration to /etc/php/pools.d/www.conf:

nano /etc/php/pools.d/www.conf
listen = /run/php-fpm/php-fpm.sock
user = nginx
group = nginx

Step 6: Configure Firewall:

Allow HTTP traffic on port 80 through the NixOS firewall using the following command:

$ sudo firewall-cmd --add-port=80/tcp --permanent
$ sudo firewall-cmd --reload

Step 7: Access ARRCON:

Access ARRCON on your web browser by entering the IP address or domain name of your NixOS Latest machine followed by /index.php:

http://example.com/index.php

You will be redirected to the ARRCON login page, where you can enter your login credentials and log in to the ARRCON dashboard.

Conclusion

Congratulations, you have successfully installed ARRCON on your NixOS Latest machine. You can now use ARRCON to manage and monitor your applications running on the Nginx web server.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!