[{"data":1,"prerenderedAt":644},["ShallowReactive",2],{"docs-ca-\u002Fdocs\u002Fplayers\u002Fkiosk":3},{"id":4,"title":5,"author":6,"body":7,"date":6,"description":636,"extension":637,"meta":638,"navigation":639,"path":640,"seo":641,"stem":642,"tags":6,"__hash__":643},"content_en\u002Fdocs\u002Fplayers\u002Fkiosk.md","Kiosk Images",null,{"type":8,"value":9,"toc":613},"minimark",[10,14,18,23,140,144,153,157,167,172,197,201,212,228,231,238,242,249,277,280,283,333,339,343,394,398,421,427,431,438,456,460,463,467,500,504,556,560,571,575,578,584,588,599,603],[11,12,5],"h1",{"id":13},"kiosk-images",[15,16,17],"p",{},"Pre-built bootable images that turn any PC or Raspberry Pi into a dedicated signage display. Flash to USB or SD card, boot, and the player starts automatically.",[19,20,22],"h2",{"id":21},"image-types","Image types",[24,25,26,42],"table",{},[27,28,29],"thead",{},[30,31,32,36,39],"tr",{},[33,34,35],"th",{},"Type",[33,37,38],{},"Format",[33,40,41],{},"Use case",[43,44,45,63,77,96,111,124],"tbody",{},[30,46,47,54,60],{},[48,49,50],"td",{},[51,52,53],"strong",{},"Offline ISO",[48,55,56],{},[57,58,59],"code",{},".iso",[48,61,62],{},"Full install with all packages included, no network needed",[30,64,65,70,74],{},[48,66,67],{},[51,68,69],{},"Netinstall ISO",[48,71,72],{},[57,73,59],{},[48,75,76],{},"Minimal installer, downloads packages during install",[30,78,79,84,89],{},[48,80,81],{},[51,82,83],{},"Disk image",[48,85,86],{},[57,87,88],{},".raw.xz",[48,90,91,92,95],{},"Flash directly to USB\u002FSD with ",[57,93,94],{},"dd"," or Raspberry Pi Imager",[30,97,98,103,108],{},[48,99,100],{},[51,101,102],{},"QCOW2",[48,104,105],{},[57,106,107],{},".qcow2",[48,109,110],{},"Virtual machines (libvirt, QEMU)",[30,112,113,118,121],{},[48,114,115],{},[51,116,117],{},"Atomic",[48,119,120],{},"OCI container → ISO",[48,122,123],{},"Immutable fedora-bootc with automatic rollback",[30,125,126,131,137],{},[48,127,128],{},[51,129,130],{},"iPXE Network Install",[48,132,133,136],{},[57,134,135],{},".usb"," (~1 MB)",[48,138,139],{},"Boot any machine from the internet — no ISO needed",[19,141,143],{"id":142},"download","Download",[15,145,146,147,152],{},"See the ",[148,149,151],"a",{"href":150},"\u002Fdownloads","Downloads"," page for the latest images.",[19,154,156],{"id":155},"boot-flow","Boot flow",[158,159,164],"pre",{"className":160,"code":162,"language":163},[161],"language-text","GDM autologin as 'xibo'\n  → GNOME Kiosk session starts\n    → Phase 1: gnome-initial-setup (language, keyboard, network, timezone, password)\n    → Phase 2: xiboplayer-setup (libadwaita wizard — player selection + CMS config)\n    → Phase 3: Selected player service starts, health monitoring begins\n  → Normal boot (setup already done):\n    → Player starts automatically with 10s health check loop\n","text",[57,165,162],{"__ignoreMap":166},"",[168,169,171],"h3",{"id":170},"phase-1-gnome-initial-setup","Phase 1: gnome-initial-setup",[15,173,174,175,178,179,182,183,182,186,182,189,192,193,196],{},"On first boot, the standard GNOME initial setup wizard runs. A ",[57,176,177],{},"vendor.conf"," skips the account, privacy, and welcome pages — only ",[51,180,181],{},"language",", ",[51,184,185],{},"keyboard",[51,187,188],{},"network",[51,190,191],{},"timezone",", and ",[51,194,195],{},"password"," remain.",[168,198,200],{"id":199},"phase-2-xiboplayer-setup","Phase 2: xiboplayer-setup",[15,202,203,204,207,208,211],{},"After system setup completes, a native ",[51,205,206],{},"libadwaita"," wizard (",[57,209,210],{},"xiboplayer-setup.py",") launches with:",[213,214,215,222],"ol",{},[216,217,218,221],"li",{},[51,219,220],{},"Player selection"," — choose Electron, Chromium, or arexibo",[216,223,224,227],{},[51,225,226],{},"CMS configuration"," (arexibo only) — CMS URL and key entry",[15,229,230],{},"For Electron and Chromium, CMS configuration happens in the player's own web-based setup page (served by the built-in proxy after the player starts).",[15,232,233,234,237],{},"The wizard writes ",[57,235,236],{},"~\u002F.local\u002Fshare\u002Fxibo\u002Fsetup-result.json"," with the selected player and service name, then the selected player's systemd service starts automatically.",[168,239,241],{"id":240},"phase-3-session-holder","Phase 3: Session holder",[15,243,244,245,248],{},"The main kiosk session (",[57,246,247],{},"gnome-kiosk-script.xibo.sh",") takes over:",[213,250,251,262,265,268,271,274],{},[216,252,253,254,257,258,261],{},"Starts ",[57,255,256],{},"dunst"," (notifications) and ",[57,259,260],{},"unclutter"," (cursor hiding)",[216,263,264],{},"Imports Wayland environment into systemd user manager",[216,266,267],{},"Disables screen blanking and GNOME donation popup",[216,269,270],{},"Starts the player service",[216,272,273],{},"Runs a health monitoring loop (checks every 10 seconds)",[216,275,276],{},"Offers reconfiguration dialog after 3 consecutive failures",[19,278,220],{"id":279},"player-selection",[15,281,282],{},"The kiosk includes all three players. The first-boot wizard lets you choose:",[24,284,285,298],{},[27,286,287],{},[30,288,289,292,295],{},[33,290,291],{},"Player",[33,293,294],{},"Priority",[33,296,297],{},"Best for",[43,299,300,311,322],{},[30,301,302,305,308],{},[48,303,304],{},"Electron",[48,306,307],{},"60 (highest)",[48,309,310],{},"PCs with GPU",[30,312,313,316,319],{},[48,314,315],{},"Chromium",[48,317,318],{},"50",[48,320,321],{},"Lightweight hardware",[30,323,324,327,330],{},[48,325,326],{},"arexibo",[48,328,329],{},"10",[48,331,332],{},"Native Rust rendering",[15,334,335,336],{},"Switch later without reconfiguring CMS: ",[57,337,338],{},"doas alternatives --set xiboplayer \u002Fusr\u002Fbin\u002Fxiboplayer-chromium",[19,340,342],{"id":341},"keyboard-shortcuts","Keyboard shortcuts",[24,344,345,355],{},[27,346,347],{},[30,348,349,352],{},[33,350,351],{},"Key",[33,353,354],{},"Action",[43,356,357,367,377],{},[30,358,359,364],{},[48,360,361],{},[57,362,363],{},"Ctrl+I",[48,365,366],{},"Show IP, CMS URL, player status",[30,368,369,374],{},[48,370,371],{},[57,372,373],{},"Ctrl+R",[48,375,376],{},"Reconfigure CMS (stops player, launches wizard)",[30,378,379,391],{},[48,380,381,384,385,384,388],{},[57,382,383],{},"D"," \u002F ",[57,386,387],{},"T",[57,389,390],{},"S",[48,392,393],{},"Download \u002F Timeline \u002F Setup overlays",[19,395,397],{"id":396},"default-credentials","Default credentials",[399,400,401,415],"ul",{},[216,402,403,406,407,384,410,406,413],{},[51,404,405],{},"User",": ",[57,408,409],{},"xibo",[51,411,412],{},"Password",[57,414,409],{},[216,416,417,420],{},[51,418,419],{},"Root",": locked",[15,422,423,424],{},"Change after first boot: ",[57,425,426],{},"passwd xibo",[19,428,430],{"id":429},"atomic-images","Atomic images",[15,432,433,434,437],{},"Atomic images are built on ",[51,435,436],{},"fedora-bootc"," — a minimal immutable base (~1.5 GB, vs 2.5 GB for Silverblue):",[399,439,440,443,450,453],{},[216,441,442],{},"Immutable OS — cannot be accidentally modified",[216,444,445,446,449],{},"Updates via ",[57,447,448],{},"bootc switch"," with automatic rollback on failure",[216,451,452],{},"Container-native — built as OCI image, converted to ISO",[216,454,455],{},"Minimal: no Firefox, no VLC, no unused GNOME apps",[19,457,459],{"id":458},"ipxe-network-install","iPXE network install",[15,461,462],{},"A ~1 MB USB stick that boots any machine over the internet and installs xiboplayer. No ISO needed — one stick installs unlimited machines.",[168,464,466],{"id":465},"how-it-works","How it works",[213,468,469,479,485,488,491,494,497],{},[216,470,471,472,475,476,478],{},"Download ",[57,473,474],{},"xiboplayer-ipxe-bios.img"," from the ",[148,477,151],{"href":150}," page",[216,480,481,482],{},"Flash to any USB stick: ",[57,483,484],{},"sudo dd if=xiboplayer-ipxe-bios.img of=\u002Fdev\u002FsdX bs=4M",[216,486,487],{},"Boot the target machine from USB",[216,489,490],{},"A menu appears — choose Full, Electron-only, or Chromium-only",[216,492,493],{},"iPXE downloads the Fedora kernel + kickstart over the internet",[216,495,496],{},"Anaconda installs everything automatically (~15-20 min)",[216,498,499],{},"Machine reboots into the kiosk first-boot wizard",[168,501,503],{"id":502},"install-profiles","Install profiles",[24,505,506,518],{},[27,507,508],{},[30,509,510,513,516],{},[33,511,512],{},"Profile",[33,514,515],{},"What's installed",[33,517,297],{},[43,519,520,533,545],{},[30,521,522,527,530],{},[48,523,524],{},[51,525,526],{},"Full",[48,528,529],{},"Electron + Chromium + arexibo",[48,531,532],{},"Maximum flexibility",[30,534,535,539,542],{},[48,536,537],{},[51,538,304],{},[48,540,541],{},"Electron only",[48,543,544],{},"Dedicated PCs with GPU",[30,546,547,551,554],{},[48,548,549],{},[51,550,315],{},[48,552,553],{},"Chromium only",[48,555,321],{},[168,557,559],{"id":558},"requirements","Requirements",[399,561,562,565,568],{},[216,563,564],{},"Ethernet or Wi-Fi (internet needed during install)",[216,566,567],{},"BIOS or UEFI with USB boot",[216,569,570],{},"20 GB+ disk",[168,572,574],{"id":573},"chainloading-from-existing-ipxe","Chainloading from existing iPXE",[15,576,577],{},"If you already have iPXE on your network:",[158,579,582],{"className":580,"code":581,"language":163},[161],"chain https:\u002F\u002Fdl.xiboplayer.org\u002Fipxe\u002Fboot.ipxe\n",[57,583,581],{"__ignoreMap":166},[168,585,587],{"id":586},"efi-boot","EFI boot",[15,589,590,591,594,595,598],{},"For UEFI-only machines, download ",[57,592,593],{},"xiboplayer-ipxe-uefi.img"," and boot it from the EFI shell or place it on a FAT32 USB as ",[57,596,597],{},"EFI\u002FBOOT\u002FBOOTX64.EFI",".",[19,600,602],{"id":601},"source","Source",[399,604,605],{},[216,606,607],{},[148,608,612],{"href":609,"rel":610},"https:\u002F\u002Fgithub.com\u002Fxibo-players\u002Fxiboplayer-kiosk",[611],"nofollow","GitHub: xibo-players\u002Fxiboplayer-kiosk",{"title":166,"searchDepth":614,"depth":614,"links":615},3,[616,618,619,624,625,626,627,628,635],{"id":21,"depth":617,"text":22},2,{"id":142,"depth":617,"text":143},{"id":155,"depth":617,"text":156,"children":620},[621,622,623],{"id":170,"depth":614,"text":171},{"id":199,"depth":614,"text":200},{"id":240,"depth":614,"text":241},{"id":279,"depth":617,"text":220},{"id":341,"depth":617,"text":342},{"id":396,"depth":617,"text":397},{"id":429,"depth":617,"text":430},{"id":458,"depth":617,"text":459,"children":629},[630,631,632,633,634],{"id":465,"depth":614,"text":466},{"id":502,"depth":614,"text":503},{"id":558,"depth":614,"text":559},{"id":573,"depth":614,"text":574},{"id":586,"depth":614,"text":587},{"id":601,"depth":617,"text":602},"Pre-built bootable images for PCs and Raspberry Pi — flash, boot, and display","md",{"order":614},true,"\u002Fdocs\u002Fplayers\u002Fkiosk",{"title":5,"description":636},"docs\u002Fplayers\u002Fkiosk","ZkWdOgl4kIV8-QoYktjxnYzS2ivcd9sTzvjJEN5Udcc",1775148111871]