SkyFactions Web

Clone Repository

Clone the GitHub repository to download all necessary files.

git clone https://github.com/JerichoTorrent/SkyFactions-web.git
cd SkyFactions-web/web-interface

Configure Database

After installing the necessary files, you can use a text editor like nano to edit db_connect.php, and enter your database connection details.

sudo apt update && sudo apt install nano
nano db_connect.php

You can edit any other files such as styles.css to modify the appearance of the site as you please.
However, it is not recommended to modify other PHP files unless you know what you are doing.

DNS Record Configuration

In your domain's DNS settings, create an A record with you intended subdomain (e.g. sky for sky.example.com), pointing to the public IP of the server that is running the web module.

Nginx Configuration

Create a new Nginx configuration file for the web interface, named after your domain.
E.g.: nano /etc/nginx/sites-available/sky.example.com.

Paste the following text into the file.

server {
    # This can also be a numerical IP.
    # Replace `sky.example.com` with your domain / IP.
    server_name sky.example.com; // [!code highlight]
 
    # Root directory for the web files
    root /home/ubuntu/SkyFactions-web/web-interface; // [!code highlight]
    index index.php index.html index.htm;
 
    # Access and error logs
    access_log /var/log/nginx/skyfactions_access.log;
    error_log /var/log/nginx/skyfactions_error.log;
 
    # Serve static files directly
    location / {
        try_files $uri $uri/ =404;
    }
 
    # PHP file handling
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        # Adjust PHP version as necessary
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock; // [!code highlight]
    }
}

After you have edited and saved the file with ctrl+x and y, create a symlink to the sites-enabled directory.

ln -s /etc/nginx/sites-available/sky.example.com /etc/nginx/sites-enabled/

Once your changes are complete, run nginx -t to check for syntax errors, and then systemctl restart nginx to apply the changes.

You can now visit your website at http://<your ip address>/index.php or http://sky.example.com/index.php if you have set up a domain.

Generate SSL Certificates

Now we can generate an SSL certificate for the site you have created.
Ensure you have Certbot installed, and run the following command:

sudo certbot --ngnix -d sky.example.com # Replace 'sky.example.com' with your domain.

If the certificate creation is successful, your site should be up and running and you can access it via https://sky.example.com/index.php.

If you wish, you can schedule a cron job to automatically renew your SSL certificates.
To do this, install cron and enter crontab.

sudo apt install cron
sudo crontab -e

At the bottom of the file, add the following line to renew the certificates every day at 11PM.

0 23 * * * certbot renew --quiet --deploy-hook "systemctl restart nginx"

In this job, Certbot will renew silently and will then restart Nginx to apply the changes.