Unraid installation🔗

Database setup🔗

You will need to have a MariaDB/MySQL container running on your Unraid server.
Your container should be in bridge mode, and you should have access to port 3306.
Ensure that your database container has the PUID of 99 (nobody) and PGID of 100 (users).

Log into your database container and add a dedicated database and user for FileRun, by run the following commands:

 1CREATE DATABASE filerun_db;

This will create a database named filerun_db.

 1GRANT ALL PRIVILEGES ON filerun_db.* TO 'filerun'@'localhost' IDENTIFIED BY 'your-password';
 2FLUSH PRIVILEGES;

This will create a user named filerun with its password your-password and will have all permissions over the filerun_db database.

FileRun setup🔗

Create the needed folders🔗

Create the following folders:

 1mkdir /mnt/user/appdata/filerun/

This is where FileRun related files will be stored.

 1mkdir /mnt/user/appdata/filerun/html/

This is for the application files.

 1mkdir /mnt/user/appdata/filerun/user-files/

This is for the user files.

Create the container🔗

Create the container from a blank template. To do this, you will need to navigate to the Docker tab in Unraid, scroll down to the bottom of the container list, and click on the Add Container button.

Once you have a blank template, you will want to go into Advanced mode by toggling the slider on top. Then you just need to set it up and add some custom variables. Here are the values for the template:

• Name: Filerun
• Repository: filerun/filerun:2026.03
• Icon/URL: https://filerun.com/images/logo.svg
• WebUI: http://IP:PORT/
• Network Type: Bridge

At the bottom of the page, click the Add another Path, Port, Variable, Label or Device link.

Configure the following as Variables:

• FR_DB_HOST = 192.168.1.3 (this is the IP address of the database container)
• FR_DB_NAME = filerun_db (this is the database name)
• FR_DB_USER = filerun (this is the database username)
• FR_DB_PASS = your-password (this is the database password)
• FR_DB_PORT = 3306 (this is the port number the database server is accessible via)

You will need to configure the following as a Port:

WebUI:

• Container Port = 80 (don't change this number)
• Host Port = 8080 (you can choose any port you want for the host port)

You will need to configure the following as Paths:

• Container path = /user-files (this is the root path that you use inside FileRun when setting home folders)
• Host path = /mnt/user/storage/filerun-storage/
• Container path = /var/www/html
• Host path = /mnt/user/appdata/filerun/html/

Complete the installation🔗

Access your server with a browser to complete the installation.