This tutorial will guide you through the installation process of GNU FM on Void Linux.
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.
GNU FM requires the following dependencies:
To install these dependencies, run:
sudo xbps-install php mariadb git
Now, we need to download the GNU FM source code. To download it, run:
git clone https://github.com/ginoperez/gnufm.git
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/
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
.
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.
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
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!