[{"data":1,"prerenderedAt":462},["ShallowReactive",2],{"docs-ca-\u002Fdocs\u002Fgetting-started\u002Fconnect-display":3},{"id":4,"title":5,"author":6,"body":7,"date":6,"description":454,"extension":455,"meta":456,"navigation":457,"path":458,"seo":459,"stem":460,"tags":6,"__hash__":461},"content_en\u002Fdocs\u002Fgetting-started\u002Fconnect-display.md","Connect a Display",null,{"type":8,"value":9,"toc":442},"minimark",[10,14,18,23,26,57,61,64,155,158,198,202,209,232,239,243,246,282,286,289,304,318,322,327,371,374,377,381,430,438],[11,12,5],"h1",{"id":13},"connect-a-display",[15,16,17],"p",{},"This guide walks you through connecting a new display to your Xibo CMS, from installation to seeing content on screen.",[19,20,22],"h2",{"id":21},"_1-prerequisites","1. Prerequisites",[15,24,25],{},"Before you start, you'll need:",[27,28,29,42,51],"ul",{},[30,31,32,36,37,41],"li",{},[33,34,35],"strong",{},"Xibo CMS URL"," — the address of your CMS (e.g., ",[38,39,40],"code",{},"https:\u002F\u002Fcms.example.com",")",[30,43,44,47,48],{},[33,45,46],{},"CMS Secret Key"," — found in your CMS under ",[33,49,50],{},"Settings → Display Settings → CMS Secret Key",[30,52,53,56],{},[33,54,55],{},"A player device"," — a Linux PC, Raspberry Pi, or any machine with a browser",[19,58,60],{"id":59},"_2-install-the-player","2. Install the player",[15,62,63],{},"Choose the player that fits your hardware:",[65,66,67,83],"table",{},[68,69,70],"thead",{},[71,72,73,77,80],"tr",{},[74,75,76],"th",{},"Player",[74,78,79],{},"Best for",[74,81,82],{},"Install",[84,85,86,104,120,138],"tbody",{},[71,87,88,96,99],{},[89,90,91],"td",{},[92,93,95],"a",{"href":94},"\u002Fdocs\u002Fplayers\u002Felectron","Electron",[89,97,98],{},"Dedicated PCs with GPU",[89,100,101],{},[38,102,103],{},"dnf install xiboplayer-electron",[71,105,106,112,115],{},[89,107,108],{},[92,109,111],{"href":110},"\u002Fdocs\u002Fplayers\u002Fchromium","Chromium",[89,113,114],{},"Lightweight PCs, ARM boards",[89,116,117],{},[38,118,119],{},"dnf install xiboplayer-chromium",[71,121,122,128,131],{},[89,123,124],{},[92,125,127],{"href":126},"\u002Fdocs\u002Fplayers\u002Fkiosk","Kiosk image",[89,129,130],{},"Flash-and-boot appliances",[89,132,133,134],{},"Download ISO from ",[92,135,137],{"href":136},"\u002Fdownloads","Downloads",[71,139,140,146,149],{},[89,141,142],{},[92,143,145],{"href":144},"\u002Fdocs\u002Fplayers\u002Fpwa","PWA",[89,147,148],{},"Any browser, quick testing",[89,150,151,152],{},"Open ",[38,153,154],{},"https:\u002F\u002Fyour-cms\u002Fplayer\u002F",[15,156,157],{},"For RPM-based systems, first add the xiboplayer repository:",[159,160,165],"pre",{"className":161,"code":162,"language":163,"meta":164,"style":164},"language-bash shiki shiki-themes material-theme-lighter github-light github-dark","sudo dnf install https:\u002F\u002Fdl.xiboplayer.org\u002Frpm\u002Ffedora\u002F43\u002Fnoarch\u002Fxiboplayer-release-43-7.fc43.noarch.rpm\nsudo dnf install xiboplayer-electron\n","bash","",[38,166,167,186],{"__ignoreMap":164},[168,169,172,176,180,183],"span",{"class":170,"line":171},"line",1,[168,173,175],{"class":174},"sbgvK","sudo",[168,177,179],{"class":178},"s_sjI"," dnf",[168,181,182],{"class":178}," install",[168,184,185],{"class":178}," https:\u002F\u002Fdl.xiboplayer.org\u002Frpm\u002Ffedora\u002F43\u002Fnoarch\u002Fxiboplayer-release-43-7.fc43.noarch.rpm\n",[168,187,189,191,193,195],{"class":170,"line":188},2,[168,190,175],{"class":174},[168,192,179],{"class":178},[168,194,182],{"class":178},[168,196,197],{"class":178}," xiboplayer-electron\n",[19,199,201],{"id":200},"_3-first-launch","3. First launch",[15,203,204,205,208],{},"When the player starts for the first time, you'll see the ",[33,206,207],{},"setup page",":",[27,210,211,220,226],{},[30,212,213,216,217],{},[33,214,215],{},"CMS URL"," — enter your full CMS address including ",[38,218,219],{},"https:\u002F\u002F",[30,221,222,225],{},[33,223,224],{},"CMS Key"," — the secret key from step 1",[30,227,228,231],{},[33,229,230],{},"Display Name"," — a friendly name (e.g., \"Lobby Screen\", \"Meeting Room 3\")",[15,233,234,235,238],{},"Click ",[33,236,237],{},"Connect",". The player will register with the CMS.",[19,240,242],{"id":241},"_4-authorize-in-cms","4. Authorize in CMS",[15,244,245],{},"The player is now waiting for authorization:",[247,248,249,256,263,269,275],"ol",{},[30,250,251,252,255],{},"Log into your ",[33,253,254],{},"Xibo CMS"," web interface",[30,257,258,259,262],{},"Navigate to ",[33,260,261],{},"Displays"," in the left menu",[30,264,265,266],{},"You'll see your new display with a status of ",[33,267,268],{},"Waiting for approval",[30,270,271,272],{},"Click the row menu (three dots) → ",[33,273,274],{},"Authorise",[30,276,277,278,281],{},"Optionally, assign the display to a ",[33,279,280],{},"Display Group"," for easier scheduling",[19,283,285],{"id":284},"_5-verify-content","5. Verify content",[15,287,288],{},"After authorization:",[27,290,291,298,301],{},[30,292,293,294,297],{},"The player receives the ",[33,295,296],{},"default layout"," from the CMS",[30,299,300],{},"Content should appear within 30-60 seconds (the next collection cycle)",[30,302,303],{},"If you've scheduled specific campaigns, they'll appear according to the schedule",[15,305,306,307,309,310,313,314,317],{},"To force an immediate update, go to ",[33,308,261],{}," in the CMS, click the row menu → ",[33,311,312],{},"Send Command"," → ",[33,315,316],{},"Collect Now",".",[19,319,321],{"id":320},"_6-auto-start-on-boot","6. Auto-start on boot",[323,324,326],"h3",{"id":325},"electron-chromium-systemd","Electron \u002F Chromium (systemd)",[159,328,330],{"className":161,"code":329,"language":163,"meta":164,"style":164},"# Enable auto-start for the current user\nsystemctl --user enable xiboplayer-electron.service\n# or\nsystemctl --user enable xiboplayer-chromium.service\n",[38,331,332,338,353,359],{"__ignoreMap":164},[168,333,334],{"class":170,"line":171},[168,335,337],{"class":336},"sutJx","# Enable auto-start for the current user\n",[168,339,340,343,347,350],{"class":170,"line":188},[168,341,342],{"class":174},"systemctl",[168,344,346],{"class":345},"stzsN"," --user",[168,348,349],{"class":178}," enable",[168,351,352],{"class":178}," xiboplayer-electron.service\n",[168,354,356],{"class":170,"line":355},3,[168,357,358],{"class":336},"# or\n",[168,360,362,364,366,368],{"class":170,"line":361},4,[168,363,342],{"class":174},[168,365,346],{"class":345},[168,367,349],{"class":178},[168,369,370],{"class":178}," xiboplayer-chromium.service\n",[323,372,127],{"id":373},"kiosk-image",[15,375,376],{},"Auto-start is already configured. The display boots directly into the player.",[19,378,380],{"id":379},"troubleshooting","Troubleshooting",[65,382,383,393],{},[68,384,385],{},[71,386,387,390],{},[74,388,389],{},"Problem",[74,391,392],{},"Solution",[84,394,395,406,414,422],{},[71,396,397,400],{},[89,398,399],{},"\"Connection refused\"",[89,401,402,403,405],{},"Check the CMS URL includes ",[38,404,219],{}," and the port if non-standard",[71,407,408,411],{},[89,409,410],{},"\"Invalid server key\"",[89,412,413],{},"Verify the CMS Key matches Settings → Display Settings → CMS Secret Key",[71,415,416,419],{},[89,417,418],{},"Display stays pending",[89,420,421],{},"Check the CMS firewall allows connections from the player's IP",[71,423,424,427],{},[89,425,426],{},"Content doesn't update",[89,428,429],{},"Wait for the collection interval (default: 5 minutes) or send Collect Now",[15,431,432,433,437],{},"See the full ",[92,434,436],{"href":435},"\u002Fdocs\u002Ftroubleshooting","Troubleshooting guide"," for more solutions.",[439,440,441],"style",{},"html pre.shiki code .sbgvK, html code.shiki .sbgvK{--shiki-light:#E2931D;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .s_sjI, html code.shiki .s_sjI{--shiki-light:#91B859;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sutJx, html code.shiki .sutJx{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#6A737D;--shiki-default-font-style:inherit;--shiki-dark:#6A737D;--shiki-dark-font-style:inherit}html pre.shiki code .stzsN, html code.shiki .stzsN{--shiki-light:#91B859;--shiki-default:#005CC5;--shiki-dark:#79B8FF}",{"title":164,"searchDepth":355,"depth":355,"links":443},[444,445,446,447,448,449,453],{"id":21,"depth":188,"text":22},{"id":59,"depth":188,"text":60},{"id":200,"depth":188,"text":201},{"id":241,"depth":188,"text":242},{"id":284,"depth":188,"text":285},{"id":320,"depth":188,"text":321,"children":450},[451,452],{"id":325,"depth":355,"text":326},{"id":373,"depth":355,"text":127},{"id":379,"depth":188,"text":380},"Step-by-step guide to connecting your first display to Xibo CMS","md",{"order":188},true,"\u002Fdocs\u002Fgetting-started\u002Fconnect-display",{"title":5,"description":454},"docs\u002Fgetting-started\u002Fconnect-display","M1nqTGLtExLQdQ8Oo6m_l_n2E_3h1llFEA9KfMbNl5g",1775148111937]