Studies mean I can't work on this project a lot outside of breaks, however I hope i'll be able to fit in general support and things like bug fixes into my time. New features and such will likely come in short bursts throughout the year (if they do at all).
jfa-go currently works on Jellyfin 10.9.8, the latest version as of 31/07/2024. I should be able to maintain compatability in the future, unless any big changes occur.
If you want a bit more of a guarantee of support, I've seen these projects mentioned although haven't tried them myself.
jfa-go is a user management app for Jellyfin (and Emby as 2nd class) that provides invite-based account creation as well as other features that make one's instance much easier to manage.
Note: TrayIcon
builds include a tray icon to start/stop/restart, and an option to automatically start when you log-in to your computer. For Linux users, these builds depend on the libappindicator3-1
/libappindicator-gtk3
/libappindicator
package for Debian/Ubuntu, Fedora, and Alpine respectively.
MatrixE2EE
builds (and Linux TrayIcon
builds) include support for end-to-end encryption for the Matrix bot, but require the libolm(-dev)
dependency. .deb/.rpm/.apk
packages list this dependency, and docker images include it.
docker create \
--name "jfa-go" \ # Whatever you want to name it
-p 8056:8056 \
# -p 8057:8057 if using tls
-v /path/to/.config/jfa-go:/data \ # Path to wherever you want to store the config file and other data
-v /path/to/jellyfin:/jf \ # Only needed for password resets through Jellyfin, ignore if not using or using Emby
-v /etc/localtime:/etc/localtime:ro \ # Makes sure time is correct
hrfee/jfa-go # hrfee/jfa-go:unstable for latest build from git
sudo apt-get update && sudo apt-get install curl apt-transport-https gnupg
curl https://apt.hrfee.dev/hrfee.pubkey.gpg | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/apt.hrfee.dev.gpg
# For stable releases
echo "deb https://apt.hrfee.dev trusty main" | sudo tee /etc/apt/sources.list.d/hrfee.list
# ------
# For unstable releases
echo "deb https://apt.hrfee.dev trusty-unstable main" | sudo tee /etc/apt/sources.list.d/hrfee.list
# ------
sudo apt-get update
# For servers
sudo apt-get install jfa-go
# ------
# For desktops/servers with GUI (may pull in lots of dependencies)
sudo apt-get install jfa-go-tray
# ------
Available on the AUR as:
Download precompiled binaries from:
unzip the jfa-go
/jfa-go.exe
executable to somewhere useful.
chmod +x jfa-go
then place it somewhere in your PATH like /usr/bin
.Run the executable to start.
If you're using docker, a Dockerfile is provided that builds from source.
Otherwise, full build instructions can be found here.
Simply run jfa-go
to start the application. A setup wizard will start on localhost:8056
(or your own specified address). Upon completion, refresh the page.
Usage of jfa-go:
start
start jfa-go as a daemon and run in the background.
stop
stop a daemonized instance of jfa-go.
systemd
generate a systemd .service file.
-config, -c string
alternate path to config file. (default "/home/hrfee/.config/jfa-go/config.ini")
-data, -d string
alternate path to data directory. (default "/home/hrfee/.config/jfa-go")
-debug
Enables debug logging.
-help, -h
prints this message.
-host string
alternate address to host web ui on.
-port, -p int
alternate port to host web ui on.
-pprof
Exposes pprof profiler on /debug/pprof.
-restore string
path to database backup to restore.
-swagger
Enable swagger at /swagger/index.html
jfa-go does not run as a daemon by default. Run jfa-go systemd
to create a systemd .service
file in your current directory, which you can copy into ~/.config/systemd/user
or somewhere else.
See the wiki page.
For translations, use the weblate instance here. You can login with github.
Big thanks to those who sponsor me. You can see them below: