Hi
This is my third day using Zynthian and I’m getting to be started. I’m aware I can access filesystem via SSH (and I’m using it) but I’m curious about this: in webconf, system → file browser redirects to http://zynthian.local:8099. Nothing listen to port 8099.
Am I missing something ? (I searched in the Wiki and the forum)
Thank you
Which branch are you using?
Last table (I think): oram. Just downloaded default iso 4 days ago and playing with it.
Very precisely (from webconf):
zyncoder: oram-2503.2 (052d1d4)
zynthian-ui: oram-2503.2 (93b96c8)
zynthian-sys: oram-2503.2 (83b74f3)
zynthian-data: oram-2503.2 (561bcaf)
zynthian-webconf: oram-2503.2 (c31793e)
# If filebrowser is enabled, add access URI to info
if self.is_service_active("filebrowser"):
info['filebrowser_uri'] = "http://{}:8099".format(self.request.host)
# Change filebrowser password
try:
check_output("systemctl stop filebrowser", shell=True)
check_output(f"cd $ZYNTHIAN_SW_DIR/filebrowser; ./filebrowser users update zynthian --password \"{config['PASSWORD'][0]}\"", shell=True)
check_output("systemctl start filebrowser", shell=True)
except Exception as e:
logging.error(f"Can't set new password for filebrowser! => {e}")
return {'REPEAT_PASSWORD': "Can't set new password for File Browser!"}
IT looks like filebrowser runs under systemd control so it would be worth checking if the process is actually under systemd control
systemctl status filebrowser
My bad, the service wasn’t running, and I messed up with my grep command to find it in the list of all services 
(I have a fever today 
so I probably shouldn’t have opened this thread).
Now that I “found” the existence of the service, this is obvious that starting it makes it working better 
Here’s the journal of filebrowser. Didn’t wanted to start for some reason. Maybe because I stopped webconf to investigate on this
Apr 05 12:58:38 zynthian systemd[1]: Started filebrowser.service - Zynthian File Browser.
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: Error: flag needs an argument: 'a' in -a
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: Usage:
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: filebrowser [flags]
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: filebrowser [command]
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: Available Commands:
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: cmds Command runner management utility
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: completion Generate the autocompletion script for the specified shell
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: config Configuration management utility
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: hash Hashes a password
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: help Help about any command
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: rules Rules management utility
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: upgrade Upgrades an old configuration
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: users Users management utility
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: version Print the version number
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: Flags:
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: -a, --address string address to listen on (default "127.0.0.1")
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: -b, --baseurl string base url
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: --cache-dir string file cache directory (disabled if empty)
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: -t, --cert string tls certificate
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: -c, --config string config file path
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: -d, --database string database path (default "./filebrowser.db")
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: --disable-exec disables Command Runner feature
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: --disable-preview-resize disable resize of image previews
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: --disable-thumbnails disable image thumbnails
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: --disable-type-detection-by-header disables type detection by reading file headers
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: -h, --help help for filebrowser
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: --img-processors int image processors count (default 4)
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: -k, --key string tls key
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: -l, --log string log output (default "stdout")
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: --noauth use the noauth auther when using quick setup
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: --password string hashed password for the first user when using quick config (default "admin")
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: -p, --port string port to listen on (default "8080")
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: -r, --root string root to prepend to relative paths (default ".")
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: --socket string socket to listen to (cannot be used with address, port, cert nor key flags)
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: --socket-perm uint32 unix socket file permissions (default 438)
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: --token-expiration-time string user session timeout (default "2h")
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: --username string username for the first user when using quick config (default "admin")
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: Use "filebrowser [command] --help" for more information about a command.
Apr 05 12:58:38 zynthian filebrowser.sh[1171]: 2025/04/05 12:58:38 flag needs an argument: 'a' in -a
Apr 05 12:58:38 zynthian systemd[1]: filebrowser.service: Main process exited, code=exited, status=1/FAILURE
Apr 05 12:58:38 zynthian systemd[1]: filebrowser.service: Failed with result 'exit-code'.
Anyway, everything is working now. Sorry for the noise :s
No problem.
Within such a dynamic code base it’s easy to get lost and without loading up the self same environment you can’t test, so One quick way of nailing this is to look at the code in github and then use the Visual Studio Code viewer option ( press . , who knew?? )
You can then use the visual studio code global search to dig out references.
I just went with 8099 .
It’s getting to be a busy little system!
As you are slightly ill would you like some soup…?
One quick way of nailing this is to look at the code in github and then use the Visual Studio Code viewer option ( press . , who knew?? )
Thank you. The worst thing is that I already cloned the 3 main repos on my local machine to jump onto the code; that helped me understand a lot of things really missing in documentation (in wiki). As I have 15 years on Python dev I’m not lost at all in codebase, I found it very clear in the opposite.
Yes please 
I don’t have any left; and I won’t have any time to make some again as I’ve a big concert tomorrow and have to leave quite early for soundcheck :s
We have more soup than we know what to do with…
Life is unfair
Hi all,
I am trying to login on the Webconf - file browser but get error ‘wrong credentials’.
I assume the root user should be used? The file browser seems to be missing in the webconf docs. I can update those once this is clear to me.
I verified the filebrowser service is started and running as root.
I triple checked for mistyping the password, even copy pasting from cleartext…
(venv) root@pisound:/usr# systemctl status filebrowser
● filebrowser.service - Zynthian File Browser
Loaded: loaded (/etc/systemd/system/filebrowser.service; enabled; preset: enabled)
Active: active (running) since Mon 2025-11-17 10:54:29 CET; 11min ago
Main PID: 2186 (filebrowser.sh)
Tasks: 9 (limit: 9288)
CPU: 35ms
CGroup: /system.slice/filebrowser.service
├─2186 /bin/bash /zynthian/zynthian-sys/sbin/filebrowser.sh
└─2187 ./filebrowser -a 0.0.0.0
Nov 17 10:54:29 pisound systemd[1]: Started filebrowser.service - Zynthian File Browser.
Nov 17 10:54:29 pisound filebrowser.sh[2187]: 2025/11/17 10:54:29 Using database: /zynthian/zynthian-sw/filebrowser/fil>
Nov 17 10:54:29 pisound filebrowser.sh[2187]: 2025/11/17 10:54:29 No config file used
Nov 17 10:54:29 pisound filebrowser.sh[2187]: 2025/11/17 10:54:29 Listening on [::]:8099
Nov 17 10:54:45 pisound filebrowser.sh[2187]: 2025/11/17 10:54:45 /api/login: 403 192.168.1.224
(venv) root@pisound:/usr# ps -p 2186 -o pid,user,comm=
PID USER
2186 root filebrowser.sh
(venv) root@pisound:/usr#
Any advice on what to check next?
Version used:
oram-staging
The user is “zynthian”, not “root”.
Sorry, the default credentials for the file browser are:
user: zynthian
password: opensynth
We would like to unify and simplify the login process in the different services of zynthian, but it’s not so easy. It needs time and attention.
Regards
Thanks, this works! Added to the wiki.
