[{"data":1,"prerenderedAt":340},["ShallowReactive",2],{"doc:en:\u002Fgetting-started\u002Fconnect-a-host":3,"navigation:en":253,"surround:en:\u002Fgetting-started\u002Fconnect-a-host":336},{"page":4,"fallback":252},{"id":5,"title":6,"body":7,"description":244,"extension":245,"meta":246,"navigation":247,"path":248,"seo":249,"stem":250,"__hash__":251},"docs_en\u002Fgetting-started\u002Fconnect-a-host.md","Connect a host",{"type":8,"value":9,"toc":237},"minimark",[10,14,19,32,36,95,99,205,215,219,226,230,233],[11,12,13],"p",{},"A host is a machine that runs a daemon and your coding agents. Zekoder Desktop always has one host, your computer. You can add more.",[15,16,18],"h2",{"id":17},"when-to-add-a-host","When to add a host",[20,21,22,26,29],"ul",{},[23,24,25],"li",{},"You want agents to run on a home server, a virtual machine, or a cloud instance.",[23,27,28],{},"You want the work to keep running while your laptop is closed.",[23,30,31],{},"You want to see the same agents from several computers.",[15,33,35],{"id":34},"prepare-the-remote-machine","Prepare the remote machine",[37,38,39,42,92],"ol",{},[23,40,41],{},"Install and sign in to the coding agents you want to use on that machine.",[23,43,44,45,80,83,84,87,88,91],{},"Install Node.js 22 or newer, then install and start the daemon:",[46,47,52],"pre",{"className":48,"code":49,"language":50,"meta":51,"style":51},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","npm install -g @getpaseo\u002Fcli\npaseo\n","bash","",[53,54,55,74],"code",{"__ignoreMap":51},[56,57,60,64,68,71],"span",{"class":58,"line":59},"line",1,[56,61,63],{"class":62},"sBMFI","npm",[56,65,67],{"class":66},"sfazB"," install",[56,69,70],{"class":66}," -g",[56,72,73],{"class":66}," @getpaseo\u002Fcli\n",[56,75,77],{"class":58,"line":76},2,[56,78,79],{"class":62},"paseo\n",[81,82],"br",{},"This daemon listens on port ",[53,85,86],{},"6767"," and keeps its data in ",[53,89,90],{},"~\u002F.paseo",".",[23,93,94],{},"When asked, choose whether to enable the encrypted relay. If you decline, connect over SSH, Tailscale, or another network you control.",[15,96,98],{"id":97},"add-the-host-in-zekoder-desktop","Add the host in Zekoder Desktop",[37,100,101,112,169,202],{},[23,102,103,104,108,109,91],{},"Open ",[105,106,107],"strong",{},"Settings"," and select ",[105,110,111],{},"Add host",[23,113,114,115],{},"Pick a connection method:",[116,117,118,131],"table",{},[119,120,121],"thead",{},[122,123,124,128],"tr",{},[125,126,127],"th",{},"Method",[125,129,130],{},"Use it when",[132,133,134,149,159],"tbody",{},[122,135,136,142],{},[137,138,139],"td",{},[105,140,141],{},"Remote SSH",[137,143,144,145,148],{},"You can ",[53,146,147],{},"ssh"," to the machine. Zekoder uses your OpenSSH client and keys.",[122,150,151,156],{},[137,152,153],{},[105,154,155],{},"Direct connection",[137,157,158],{},"The machine is reachable on your local network or VPN.",[122,160,161,166],{},[137,162,163],{},[105,164,165],{},"Paste pairing link",[137,167,168],{},"You enabled the relay on the remote machine.",[23,170,171,172],{},"Fill in the address:",[20,173,174,186],{},[23,175,176,178,179,182,183,91],{},[105,177,141],{},": enter ",[53,180,181],{},"ssh:\u002F\u002Fuser@host?daemonPort=6767"," in ",[105,184,185],{},"SSH host",[23,187,188,190,191,194,195,197,198,201],{},[105,189,155],{},": enter the host name and set ",[105,192,193],{},"Port"," to ",[53,196,86],{},". The form defaults to ",[53,199,200],{},"6777",", the port of the Zekoder Desktop daemon.",[23,203,204],{},"If the daemon has a password, enter it.",[11,206,207,208,210,211,214],{},"The host appears in ",[105,209,107],{}," under ",[105,212,213],{},"Host"," and in the sidebar's host filter. New workspaces ask which host to use.",[15,216,218],{"id":217},"zekoder-workflow-on-a-remote-host","Zekoder workflow on a remote host",[11,220,221,222,225],{},"The Issues, Reports, and Zekoder pages come from the Zekoder plugin, which runs on the host. When the active host does not have it, the sidebar shows ",[105,223,224],{},"This host lacks Zekoder",". In this version, run the Zekoder workflow on your local host.",[15,227,229],{"id":228},"keep-your-code-private","Keep your code private",[11,231,232],{},"Agents run on the host you choose and your code stays on that machine. The optional relay only carries end-to-end encrypted traffic between your devices.",[234,235,236],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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);}",{"title":51,"searchDepth":76,"depth":76,"links":238},[239,240,241,242,243],{"id":17,"depth":76,"text":18},{"id":34,"depth":76,"text":35},{"id":97,"depth":76,"text":98},{"id":217,"depth":76,"text":218},{"id":228,"depth":76,"text":229},"Run agents on another machine or server and control them from Zekoder Desktop.","md",{},{"order":76},"\u002Fgetting-started\u002Fconnect-a-host",{"title":6,"description":244},"getting-started\u002Fconnect-a-host","3-K2vzQr_EKc0sO2hocyY1qgAq3wZEHuy-l1KP8Ft0o",false,[254,259,273,301,331],{"title":255,"path":256,"stem":257,"order":258},"Zekoder documentation","\u002F","index",-1,{"title":260,"path":261,"stem":262,"children":263,"page":252},"Getting started","\u002Fgetting-started","getting-started",[264,268,272],{"title":265,"path":266,"stem":267},"Install","\u002Fgetting-started\u002Finstall","getting-started\u002Finstall",{"title":269,"path":270,"stem":271,"order":59},"Quick start","\u002Fgetting-started\u002Fquick-start","getting-started\u002Fquick-start",{"title":6,"path":248,"stem":250,"order":76},{"title":274,"path":275,"stem":276,"children":277,"page":252},"Using Zekoder","\u002Fusing-zekoder","using-zekoder",[278,282,286,291,296],{"title":279,"path":280,"stem":281,"order":59},"Projects and workspaces","\u002Fusing-zekoder\u002Fprojects-and-workspaces","using-zekoder\u002Fprojects-and-workspaces",{"title":283,"path":284,"stem":285,"order":76},"Agents and the composer","\u002Fusing-zekoder\u002Fagents","using-zekoder\u002Fagents",{"title":287,"path":288,"stem":289,"order":290},"Review changes","\u002Fusing-zekoder\u002Freview-changes","using-zekoder\u002Freview-changes",3,{"title":292,"path":293,"stem":294,"order":295},"Keyboard shortcuts","\u002Fusing-zekoder\u002Fkeyboard-shortcuts","using-zekoder\u002Fkeyboard-shortcuts",4,{"title":297,"path":298,"stem":299,"order":300},"Settings and updates","\u002Fusing-zekoder\u002Fsettings-and-updates","using-zekoder\u002Fsettings-and-updates",5,{"title":302,"path":303,"stem":304,"children":305,"page":252},"Zekoder workflow","\u002Fzekoder-workflow","zekoder-workflow",[306,310,314,318,322,326],{"title":307,"path":308,"stem":309,"order":59},"How the workflow works","\u002Fzekoder-workflow\u002Foverview","zekoder-workflow\u002Foverview",{"title":311,"path":312,"stem":313,"order":76},"Commands","\u002Fzekoder-workflow\u002Fcommands","zekoder-workflow\u002Fcommands",{"title":315,"path":316,"stem":317,"order":290},"The Issues screen","\u002Fzekoder-workflow\u002Fissues","zekoder-workflow\u002Fissues",{"title":319,"path":320,"stem":321,"order":295},"Project settings","\u002Fzekoder-workflow\u002Fproject-settings","zekoder-workflow\u002Fproject-settings",{"title":323,"path":324,"stem":325,"order":300},"Coding health reports","\u002Fzekoder-workflow\u002Freports","zekoder-workflow\u002Freports",{"title":327,"path":328,"stem":329,"order":330},"Versions and updates","\u002Fzekoder-workflow\u002Fversion","zekoder-workflow\u002Fversion",6,{"title":332,"path":333,"stem":334,"order":335},"What changed","\u002Fwhats-changed","whats-changed",99,[337,338],null,{"title":265,"path":266,"stem":267,"description":339,"children":-1},"Install Zekoder Desktop on macOS, Windows, or Linux and open it for the first time.",1792573526857]