Installation via package managers (RHEL/Fedora)

Ferron has official packages available for Red Hat Enterprise Linux (RHEL), Fedora, and derivatives. Below are the instructions on how to install Ferron on RHEL or Fedora via a package manager.

Installation steps

1. Add Ferron’s repository

To add Ferron’s repository, run the following commands:

# Install packages required for adding a new repository
sudo yum install yum-utils

# Add a new RPM package repository
sudo yum-config-manager --add-repo https://rpm.ferron.sh/ferron.repo

2. Install Ferron

To install Ferron web server, run the following command:

sudo yum install ferron

3. Enable and start the service

To enable and start the Ferron service, run the following commands:

sudo systemctl enable ferron
sudo systemctl start ferron

4. Access the web server

By default, Ferron serves content from the /var/www/ferron directory. Open a web browser and navigate to http://localhost to verify that the server is running and serving the default index.html file.

File structure

Ferron installed via the installer for GNU/Linux has following file structure:

  • /usr/sbin/ferron - Ferron web server
  • /usr/sbin/ferron-passwd - Ferron user password generation tool
  • /usr/sbin/ferron-yaml2kdl - Ferron configuration conversion tool
  • /var/log/ferron/access.log - Ferron access log in Combined Log Format
  • /var/log/ferron/error.log - Ferron error log
  • /var/www/ferron - Ferron’s web root
  • /etc/ferron.kdl - Ferron configuration

Managing the Ferron service

Stopping the service

To stop the Ferron service, run:

sudo systemctl stop ferron

Restarting the service

To restart the service:

sudo systemctl restart ferron

Reloading the configuration

To reload the configuration without restarting the service:

sudo systemctl reload ferron