Support thread for masterwishx - FileBrowser Quantum https://hub.docker.com/r/gtstef/filebrowser docker image.

FileBrowser Quantum provides an easy way to access and manage your files from the web. It has a modern responsive interface that has many advanced features to manage users, access, sharing, and file preview and editing.

This version is called "Quantum" because it packs tons of advanced features into a tiny easy to run file. Unlike the majority of alternative options, FileBrowser Quantum is simple to install and easy to configure.

https://github.com/gtsteffaniak/filebrowser

Config

https://github.com/gtsteffaniak/filebrowser/blob/main/frontend/public/config.generated.yaml

Read

https://filebrowserquantum.com/en/docs/getting-started/

NOTE:

1. First make folders and set permissions:

mkdir -p /mnt/user/appdata/filebrowserQuantum/tmp

chown -R 1000:100 /mnt/user/appdata/filebrowserQuantum

chmod 755 /mnt/user/appdata/filebrowserQuantum

chmod -R 777 /mnt/user/appdata/filebrowserQuantum/tmp

2. Download config and put to "/filebrowserQuantum" folder.

https://github.com/masterwishx/unraid-templates/tree/main/configs/filebrowserQuantum/config.yaml

3. Make share for files "FileBrowser Files", then make folder for users.

mkdir -p /mnt/user/FileBrowser Files/users

chown -R 1000:100 /mnt/user/FileBrowser Files/users

4. Enjoy

Warning:

After the first login using admin:admin , change the password or create a new admin user.

If you do not update the credentials in the config file like this:

'adminUsername: "**hidden**"'

'adminPassword: ""'

Then the default admin values will be restored after a container restart.

Edited November 14, 2025Nov 14 by Masterwishx

Thank you very much, that's exactly what I was looking for!

I appreciate your work and effort for your first stable release!

Some additions would be great:

• if there would be a privilged user who can do everything, but not taking the admin rights from the real admin

• rules for passwords to make it safer if this service is public

Other than that, it's the best tool I have seen so far to share data with friends!

Edited November 10, 2025Nov 10 by Felix2M

Hi, any Idea why my unraid GUI crashes when I try to install ?
I click on install, and then it hangs adding the container ( opening the template)

Tried on 2 browser and on Smartphone... I also cannot open unraid web GUI again without closing the browser first.

Mike

PS: I could not create a share with a space in the name, so I created share "FileBrowser" but this should be no problem where my installation hangs

Edited November 12, 2025Nov 12 by mmm77

2 hours ago, mmm77 said:

Hi, any Idea why my unraid GUI crashes when I try to install ?
I click on install, and then it hangs adding the container ( opening the template)

Tried on 2 browser and on Smartphone... I also cannot open unraid web GUI again without closing the browser first.

Mike

PS: I could not create a share with a space in the name, so I created share "FileBrowser" but this should be no problem where my installation hangs

restart of unraid server did help.

PS: maybe it is better to tell command: wget https://github.com/masterwishx/unraid-templates/raw/refs/heads/main/configs/filebrowserQuantum/config.yaml

(also changed link to raw file)

Edited November 12, 2025Nov 12 by mmm77

Hi! Thanks for the template. I was able to get it to work, but I have a question.

Currently, we are asked to create the config.yaml in /home/filebrowser/data (container path). However, after boot, a database and config file will be automatically created at /home/filebrowser/data (notice the lack of "data" folder). When making changes in the app, only the config in /home/filebrowser/ will be modified, NOT the one we mapped the path.

Of course, the easiest solution would be to map the host to /home/filebrowser/, but doing this gives me an error, because it overrides the container's filesystem, which is required to boot the app in the first place (it runs ./filebrowser).

Now, here is what I did to get it to work correctly - I just don't know if it's going to work well with future updates.

Start the container with the default settings, which will create the duplicated files in /home/filebrowser/. Use the container's console to copy all the files an folders from /home/filebrowser/ to /home/filebrowser/data (your mapped path) using this commands:

cp -r -f /home/filebrowser/filebrowser /home/filebrowser/data

cp -r -f /home/filebrowser/http /home/filebrowser/data

Here, the -r is for reccursive (the http folder won't work otherwise).

Once that's done, you should see these files on your host's mapped path. Stop the FileBrowser container and edit it. Change your paths to remove "/data" in the container paths. So, for example, replace all instances of "/home/filebrowser/data" with "/home/filebrowser". Make the necessary edits to your config.yaml so that the paths point to the correct database and tmp folders (I highly recommend using full paths, ie "/home/filebrowser/database.db" to avoid confusion). Re-execute the chown and chmod commands from the "Additional Requirements" section of the template. Restart the container.

Check the logs - all should be normal. What we did here is map the paths correctly and ensure that the mapped folder has the required scripts for FileBrowser to start. Feel free to make changes to your settings in the app, and you should now see your mapped config.yaml be properly updated.

Edited November 14, 2025Nov 14 by Dashrendar2507
Added a reminder to make edits to the config.yaml before restarting the container for the last time.

On 11/12/2025 at 10:17 AM, mmm77 said:

I could not create a share with a space in the name, so I created share "FileBrowser" but this should be no problem where my installation hangs

Yep its my old share for old version of File Browser . so you can make FileBroweser or File_Broweser or other folder like /mnt/user/Files/File_Broweser and then use it in mapping

On 11/10/2025 at 4:25 AM, Felix2M said:

Thank you very much, that's exactly what I was looking for!

I appreciate your work and effort for your first stable release!

im only made XML Template for Unraid, not the app maintainer

13 hours ago, Dashrendar2507 said:

Of course, the easiest solution would be to map the host to /home/filebrowser/, but doing this gives me an error, because it overrides the container's filesystem, which is required to boot the app in the first place (it runs ./filebrowser).

Sorry not sure what you mean , we have :

https://github.com/gtsteffaniak/filebrowser/blob/18738b327313acf6cc76dc41acd4a363928360d1/_docker/Dockerfile#L29

ENV FILEBROWSER_DATABASE="/home/filebrowser/data/database.db"

ENV PATH="$PATH:/home/filebrowser"

Edited November 14, 2025Nov 14 by Masterwishx

13 hours ago, Dashrendar2507 said:

Currently, we are asked to create the config.yaml in /home/filebrowser/data (container path). However, after boot, a database and config file will be automatically created at /home/filebrowser/data (notice the lack of "data" folder). When making changes in the app, only the config in /home/filebrowser/ will be modified, NOT the one we mapped the path.

You was need to download and put my config in path , but db create automatically for the first time, in any way we have the real config that saved in db after app loaded when open app in User Settings->System and Admin->Load config settings#systemAdmin-main ,so you can copy from here and save in your config file.

I just started working on an Unraid template this weekend, then today I noticed yours. Great!
I created this icon that is a little cleaner (no black circle background), perhaps you´d like to use it:

https://raw.githubusercontent.com/rschuiling/unraid-templates/refs/heads/main/icons/logo_filebrowser-quantum.png 

One recommendation for your template: you could change the WebUI to http://[IP]:[PORT:8890]/files. The port is now 80, should be 8890 for the WebUI url to work with the default settings.

Edited November 14, 2025Nov 14 by Emphyrio

1 hour ago, Emphyrio said:

The port is now 80, should be 8890 for the WebUI

Thanks for the icon I will check it.

The port in webui should be the port of container, then it's converted by unraid to the host port when you click on it.

Owner of this template, but should be fixed path. It doesn`t work and also commands for create folders should automatically included in installation procedure.

2025/11/20 13:42:57 [ERROR] Error during indexing: error getting disk usage for /srv/users: no such file or directory

It is really weird to have a files only inside /users folder. If somebody would like to use existed files - need to create /users folder and copy all files?

Edited November 20, 2025Nov 20 by d3m3zs

MakeUserDirs: scope folder does not exist: /srv/users

This is the error I get on first start. Looking at the folders that were created as per the pre-requisites on install, there is no /srv/users directory.
Should I create this manually and if so, where should they be created?
Really would love to use this but I can't get it running properly.
Any help is appreciated! Thanks in advance :)

Edited November 21, 2025Nov 21 by LordShad0w

30 minutes ago, LordShad0w said:

Should I create this manually and if so, where should they be created?

Please read the firs post.

18 hours ago, d3m3zs said:

It is really weird to have a files only inside /users folder

You can use any other folder if you you need. Check first post

I found the section in question.
It apparently was not in the main install page in CA.

It did not answer my question though. Where does the /srv/users go?
It is not currently found or created, so if you could please tell me where it is or where I should create it, I would appreciate it.

Edited November 21, 2025Nov 21 by LordShad0w

Anyone have some info on this? I followed the instructions to the letter and what is mentioned in this error has nothing relating to any of the command issued or directories created.
I would really appreciate some help from those of you who have this all working. :)

I think it has something to do with your setting for Host Path 1. This points to the container path /srv, that is the location inside the container where FileBrowser looks for the files it has to serve up. When you followed the instructions, you made a new share in Unraid called FileBrowser Files (case sensitive). Within that share, you created a users folder.

Maybe this helps: you don't have to create a folder called srv yourself. This folder is inside the container, already prepared. You just map the location of the share you created to the container path 'srv'. It could look like this (default settings):

This assumes you have succesfully ran these commands in the Unraid terminal:
mkdir -p /mnt/user/FileBrowser Files/users

chown -R 1000:100 /mnt/user/FileBrowser Files/users

4 minutes ago, Emphyrio said:

I think it has something to do with your setting for Host Path 1. This points to the container path /srv, that is the location inside the container where FileBrowser looks for the files it has to serve up. When you followed the instructions, you made a new share in Unraid called FileBrowser Files (case sensitive). Within that share, you created a users folder.

Maybe this helps: you don't have to create a folder called srv yourself. This folder is inside the container, already prepared. You just map the location of the share you created to the container path 'srv'. It could look like this (default settings):

This assumes you have succesfully ran these commands in the Unraid terminal:
mkdir -p /mnt/user/FileBrowser Files/users

chown -R 1000:100 /mnt/user/FileBrowser Files/users

Strange, I see what happened but don't know how to fix it.
It is as follows: I ran the commands initially but apparently did not realize that apparently the folders (users etc.) were NOT created.
I ran the commands above again, and they are still not created.
i am not sure how to proceed. I am on the root account, so permissions are not an issue.
Any idea what it could be?
Also thank you for being kind and helpful. It is increasingly rare online these days apparently.

1 hour ago, LordShad0w said:

i am not sure how to proceed. I am on the root account, so permissions are not an issue.
Any idea what it could be?
Also thank you for being kind and helpful. It is increasingly rare online these days apparently.

Post your container settings, and cli from the host:

`ls -lah "/mnt/user/FileBrowser Files/"`

Edited November 23, 2025Nov 23 by Masterwishx

I got the container running without to much problems but right now it seems to be limited to the one directory if I want to use this to access files on the array other then what is in that one directory how would I go about doing that? I did try to add the path in the config via Source Configuration path entry but that didn't work, I then tried to add it as a path in the template and that didn't work. Looks great but of limited use compared to Krusader if you can't look at more then one directory.

11 hours ago, PatrickS said:

Looks great but of limited use compared to Krusader if you can't look at more then one directory.

You can add more paths to container also to config, just read the docs..

On 11/23/2025 at 2:06 AM, Masterwishx said:

Post your container settings, and cli from the host:

`ls -lah "/mnt/user/FileBrowser Files/"`

It showed nothing.
Don't sweat it, I uninstalled it. Seemed like a nice tool though.

On 11/20/2025 at 10:29 PM, Masterwishx said:

Please read the firs post.

Perhaps you could try being a bit more understanding in the future since this is support thread and you are the dev.
Not everyone is super familiar with Linux or with new tools.
From your github comments I noticed you say you don't care about users that don't know Docker.
Not the greatest attitude considering that that is 90+% of Community Apps.

Anyhow, I hope you choose to take this as constructive criticism since that is how it is intended. Best of luck in the future.

19 hours ago, LordShad0w said:

Don't sweat it, I uninstalled it. Seemed like a nice tool though.

You can try then old version FileBrowser.

19 hours ago, LordShad0w said:

Perhaps you could try being a bit more understanding in the future since this is support thread and you are the dev.

I'm not the dev of container you can see it by my nick at least here and on github. I only made xml template for unraid :)

Ok, cool. Doesn't change my point though. You lose nothing by being actually helpful in a help thread.
Basically saying RTFM after someone has explained that they followed all the given steps and have reached an impasse...
Kind of a dick move. :)