Quick Start

Two ways to set up a signage display: flash a ready-made image (recommended) or install packages on existing Linux.

💿 Flash a ready-made image

Xibo Kiosk images include everything: the operating system, auto-login, a setup wizard, all players, health monitoring, and automatic updates. Pick your hardware:

🖥️

PC or laptop

Installer ISO

Flash the ISO to a USB stick with Balena Etcher or dd. Boot from USB — automated install. Remove USB and reboot.

Download ISO →

🍓

Raspberry Pi 4/5

Raw image (aarch64)

Flash the .raw.xz image to an SD card with Balena Etcher. Insert the card, power on — boots ready to use.

Download aarch64 →

💻

Virtual machine

QCOW2

Ready-to-boot VM image. Open in GNOME Boxes, virt-manager, Proxmox or run directly with QEMU. No installation needed.

Download QCOW2 →

🔧

Intel NUC / embedded

Raw image (x86_64)

Write the .raw.xz image directly to the internal SSD or SD card. Same as the Pi image but for Intel/AMD hardware.

Download x86_64 →

After booting

Log in with user xibo / password xibo. Change your password with passwd. The setup wizard appears — enter your CMS URL, server key, and display name. Go to your CMS → Displays → Authorize the new display. Content starts playing automatically.

All image types and flashing instructions

📦 Install on existing Linux

Install xiboplayer-kiosk on your existing Fedora, Ubuntu or Debian system. It configures auto-login, a kiosk session, health monitoring, and the Electron player — without reinstalling the OS.

What gets installed

A dedicated kiosk user with auto-login, a fullscreen GNOME Kiosk session, health monitoring with auto-restart, on-screen notifications (Dunst), and keyboard shortcuts (keyd). Reboot to start the kiosk.

Choose a player

sudo dnf install xiboplayer-electron    # Recommended
sudo dnf install xiboplayer-chromium    # Lightweight alternative
sudo dnf install arexibo                # Native Rust player

Next Steps

🔗

Configure CMS connection

🔧

Troubleshooting

Common issues and solutions

💿

Flash an image

All image types and instructions

⚡

Player details

Detailed setup for each player