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.
Before you begin, you need to have the following:
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
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
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.
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
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
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
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.
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!