To get back to the main page, click here.

To view the list of image building, click here.

To view the basic manual, click here.

To view the detailed graphic guides, click here.

To view the contents of these manuals, click here.

FileBrowser Service

Updated on 4/19/2022

You can find the official website of FileBrowser here:

https://filebrowser.org/

Now we recommend launching the desktop with another port exposed:

docker run --gpus all -it --rm --shm-size=1g -v ~:/homelocal -v /raid/myname:/data -p 6080:6080 -p 5212:5212 xubuntu:1.7

The first 5212 can be modified to another value in case of port occupation. To perform the initial configuration, we recommend running the desktop in interactive mode, making the configurations to FileBrowser, and saving the image.

After that, users can get into the desktop, start a new terminal, and run

fbrowser

It will start another service. If you get access to the desktop by

http://xxx.xx.xx.xxx:6080/vnc.html

Now you can get access to FileBrowser by

http://xxx.xx.xx.xxx:5212/

The initial configuration

This part is very important because the administrator of FileBrowser has such information:

User:     admin
Password: admin

It is very unsafe. So you need to log in with the initial password, and enter the user management page, then modify your admin password.

User management

Then, you can configure your password and allowed commands:

Configure password	Configure allowed commands

The recommended administrator’s commands are:

sudo ls cd cp rm ln mv chmod chown chgrp yjin-tool git tar zip unzip

You can also create a new non-admin user, we recommend you to always use this non-admin user for safety issues:

Configure password	Configure allowed commands

The recommended user’s commands are:

ls cd ln chmod chown chgrp yjin-tool git tar zip unzip

After all, you can log in with a non-admin user. Now you can

• Upload or download a file.
• Preview, move or delete files on DGX.
• Modify some text-based files, like .txt, .sh, …
• Share a file by link. This link can get accessed by anybody on the same LAN.
• Use some commands, for example, use tar to zip/unzip files.

Run a command

After finishing the above configurations, you can save your image. Your configurations will be remembered.

Note that this command line is not a bash command line. Running a program is OK, but many commands are restricted.

Run with a different root folder

By default, the root folder of FileBrowser is /homelocal. You can also change it to a different path, like /data. Just specify the argument like this:

fbrowser rootdir=/data

Start FileBrowser together with the desktop

You can specify the argument --filebrowser when launching the container. Then the FileBrowser will be opened together with the desktop service:

docker run --gpus all -it --rm --shm-size=1g -v ~:/homelocal -v /raid/myname:/data -p 6080:6080 -p 5212:5212 xubuntu:1.7 --filebrowser fb_rootdir=/data

where fb_rootdir is the root directory of FileBrowser. If not specified, will use /homelocal.

Actually, we recommend users opening FileBrowser always on a terminal inside the desktop. This configuration will help users to control the service better.

Do not open Cloudreve and Filebrowser at the same time, unless you know what you are doing and how to configure your ports.

Explain the fbrowser command

The command

fbrowser rootdir=/data port=5212

is just an abbr. of this command:

USER_ROOT=/home/xubuntu
MACHINE_IP=$(hostname -I | awk 'NR==1 {print $1}')
filebrowser -r /data -a $MACHINE_IP -p 5212 -d "${USER_ROOT}/filebrowser/fb-database.db"

The database used for storing the user information is saved in /home/xubuntu/filebrowser/fb-database.db. Note that this path is inside the container, and it is not mounted folder!