Unraid installation

You will need to have a MariaDB container running on your Unraid server as FileRun requires a MySQL database.

If you already have a MariaDB container:

First, configure MariaDB by adding a database for FileRun. Your container should be in bridge mode, and you should have access to port 3306. Also, ensure that your MariaDB container has the PUID of 99 and PGID of 100 (nobody and users).

In your MariaDB (or MySQL) container, add your database and user for FileRun. I'll use examples for this guide, but I highly recommend changing the variables:

  • database: filerun_db
  • user: filerun
  • password: filerun

Log into your MariaDB container and run the following commands: 

CREATE DATABASE filerun_db;
GRANT ALL PRIVILEGES ON filerun_db.* TO 'filerun'@'localhost' IDENTIFIED BY 'filerun';
FLUSH PRIVILEGES;

If you're creating a container for FileRun only: If you are creating a MariaDB instance for the sole purpose of FileRun, you can use the template below:

Setup a FileRun container:

First, you will need to get your FileRun files from your account page. Make sure to download the PHP 8.1 version. Once you download the zip file, transfer it to your Unraid server. I recommend moving it to “/mnt/user/appdata/filerun/”. You'll need to create that path and set the permissions to the folder. 

mkdir /mnt/user/appdata/filerun/
cd /mnt/user/appdata/filerun/
mkdir ./html/ ./user-files/

Navigate to your html folder, copy the zip file into the html folder, and extract the zip file. 

unzip FILERUNZIP.zip

Then, set the permissions to the system/data folder. 

chown nobody:users -R /mnt/user/appdata/filerun/html/system/data

Note: whatever path you choose to store the application, make note of that because you will need to create a path variable in the Unraid template.

Now, 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:

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

You will need to configure the following as Variables:

  • “FR_DB_HOST” = 192.168.1.3
  • “FR_DB_NAME” = filerun_db
  • “FR_DB_USER” = filerun
  • “FR_DB_PASS” = filerun
  • “FR_DB_PORT” = 3306
  • “APACHE_RUN_USER” = nobody
  • “APACHE_RUN_USER_ID” = 99
  • “APACHE_RUN_GROUP” = users
  • “APACHE_RUN_GROUP_ID” = 100

You will need to configure the following as a Port:

WebUI: Container Port = “80” ⇒ 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” ⇒ Host path = “/mnt/user/storage/filerun-storage/”
  • Container path = “/var/www/html” ⇒ Host path = “/mnt/user/appdata/filerun/html/”

Once you have it completed, you should be able to install the container and configure it based.

As a final note, remember to make sure that you complete the setup on the authorized DNS name you registered with FileRun when you purchased a license.