Skip to content

Install on Linux

kino ships as a native package on every major distro. Pick the line that matches your system.

Terminal window
# Download .deb from the latest GitHub release
sudo apt install ./kino_<version>_amd64.deb

This 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:

Terminal window
sudo systemctl status kino
sudo systemctl restart kino
sudo journalctl -u kino -f
Terminal window
sudo dnf install ./kino-<version>.x86_64.rpm

Same systemd integration as the .deb package.

Terminal window
yay -S kino-bin
# or paru -S kino-bin

Pulls the kino-bin package from the AUR (binary release, not source build). Maintained by the kino release pipeline; refreshed automatically on each release.

If your distro isn’t covered above:

Terminal window
curl -fsSL https://github.com/kinostack-app/kino/releases/latest/download/kino-x86_64.AppImage -o kino.AppImage
chmod +x kino.AppImage
./kino.AppImage serve

The AppImage is self-contained except for FFmpeg, which kino expects on PATH:

Terminal window
sudo apt install ffmpeg # Debian / Ubuntu
sudo dnf install ffmpeg # Fedora

To run as a system service:

Terminal window
sudo ./kino.AppImage install-service

To remove:

Terminal window
sudo ./kino.AppImage uninstall-service

kino listens on port 8080 by default. Adjust your distro’s firewall:

Terminal window
# ufw (Debian/Ubuntu)
sudo ufw allow 8080/tcp
# firewalld (Fedora/RHEL)
sudo firewall-cmd --add-port=8080/tcp --permanent
sudo firewall-cmd --reload

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:

Terminal window
kino install-tray

By default kino stores its database + cached metadata in a per-OS location:

ModePath
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.