How to Install GNU FM on Void Linux

This tutorial will guide you through the installation process of GNU FM on Void Linux.

Prerequisites

• A running instance of Void Linux.
• A root user account.

Step 1: Update the system

Before starting any installation process we have to make sure that our operating system is updated. To update your system, run:

sudo xbps-install -Syu

This will update your system to the latest version.

Step 2: Install Dependencies

GNU FM requires the following dependencies:

• PHP >= 5.6
• MariaDB or MySQL
• Git

To install these dependencies, run:

sudo xbps-install php mariadb git

Step 3: Download GNU FM

Now, we need to download the GNU FM source code. To download it, run:

git clone https://github.com/ginoperez/gnufm.git

Step 4: Install GNU FM

To install GNU FM, we have to move the downloaded source code to the web root directory. By default, the web root directory is /var/www/htdocs/.

Run the following commands to move the GNU FM source code:

sudo mv gnufm /var/www/htdocs/
sudo chown -R http:http /var/www/htdocs/gnufm/

Step 5: Configure Database

GNU FM requires a database to store its data. In Void Linux, we have to install MariaDB or MySQL to create a database.

To install MariaDB, run:

sudo xbps-install mariadb

To install MySQL, run:

sudo xbps-install mysql

Once the database is installed, run the following command to secure your database:

sudo mysql_secure_installation

Next, we have to create a database for GNU FM. Connect to the MySQL or MariaDB server using the following command:

mysql -u root -p

Run the following commands to create a database and give privileges to the database user:

CREATE DATABASE gnufm;
GRANT ALL ON gnufm.* TO 'gnufmuser'@'localhost' IDENTIFIED BY 'yourpassword';

Replace yourpassword with a strong password.

Exit the MySQL or MariaDB console by running exit.

Step 6: Configure GNU FM

Now, let's configure the GNU FM software. We have to set the database credentials in the config.php file.

Move to the GNU FM directory by running:

cd /var/www/htdocs/gnufm/

Edit the config.php file using your preferred text editor:

sudo nano config.php

Replace the following values:

$dbuser = "gnufmuser";
$dbpass = "yourpassword";
$dbname = "gnufm";

Save and exit the config.php file.

Step 7: Restart Required Services

Finally, restart the required services to make the changes effective.

To restart Apache web server, run:

sudo svc -t /var/service/apache

To restart MariaDB or MySQL, run:

sudo svc -t /var/service/mariadb
sudo svc -t /var/service/mysql

Step 8: Access GNU FM

Open your web browser and enter the following URL:

http://localhost/gnufm/

The GNU FM web interface should now be visible. Follow the on-screen instructions to continue with the installation process.

Congratulations, you have successfully installed GNU FM on Void Linux!

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!

Alternatively, for the best virtual desktop, try Shells!