Install on Linux
kino ships as a native package on every major distro. Pick the line that matches your system.
Debian / Ubuntu
Section titled “Debian / Ubuntu”# Download .deb from the latest GitHub releasesudo apt install ./kino_<version>_amd64.debThis installs the binary, registers a kino systemd service, creates
a kino service user, and starts the server. Open
http://localhost:8080 and run through the setup wizard.
Service control:
sudo systemctl status kinosudo systemctl restart kinosudo journalctl -u kino -fFedora / RHEL
Section titled “Fedora / RHEL”sudo dnf install ./kino-<version>.x86_64.rpmSame systemd integration as the .deb package.
Arch Linux
Section titled “Arch Linux”yay -S kino-bin# or paru -S kino-binPulls the kino-bin
package from the AUR (binary release, not source build). Maintained
by the kino release pipeline; refreshed automatically on each
release.
AppImage (any glibc distro)
Section titled “AppImage (any glibc distro)”If your distro isn’t covered above:
curl -fsSL https://github.com/kinostack-app/kino/releases/latest/download/kino-x86_64.AppImage -o kino.AppImagechmod +x kino.AppImage./kino.AppImage serveThe AppImage is self-contained except for FFmpeg, which kino
expects on PATH:
sudo apt install ffmpeg # Debian / Ubuntusudo dnf install ffmpeg # FedoraTo run as a system service:
sudo ./kino.AppImage install-serviceTo remove:
sudo ./kino.AppImage uninstall-serviceFirewall
Section titled “Firewall”kino listens on port 8080 by default. Adjust your distro’s
firewall:
# ufw (Debian/Ubuntu)sudo ufw allow 8080/tcp
# firewalld (Fedora/RHEL)sudo firewall-cmd --add-port=8080/tcp --permanentsudo firewall-cmd --reloadTray + autostart
Section titled “Tray + autostart”The .deb and .rpm packages ship the desktop tray (system tray
icon + menu). On GNOME 40+, install the
AppIndicator and KStatusNotifierItem extension
so the icon shows up.
To enable per-user autostart of the tray:
kino install-trayConfiguring the data directory
Section titled “Configuring the data directory”By default kino stores its database + cached metadata in a per-OS location:
| Mode | Path |
|---|---|
| systemd service | /var/lib/kino/ |
User mode (--user install) | $XDG_DATA_HOME/kino/ (typically ~/.local/share/kino/) |
| AppImage (no service) | $XDG_DATA_HOME/kino/ |
Override via --data-path /path/to/dir or KINO_DATA_PATH=/path/to/dir.