[{"data":1,"prerenderedAt":611},["ShallowReactive",2],{"navigation":3,"\u002Fgetting-started\u002Finstallation":57},[4,22,35,44],{"title":5,"path":6,"stem":7,"children":8,"page":21},"Getting Started","\u002Fgetting-started","1.getting-started",[9,13,17],{"title":10,"path":11,"stem":12},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":14,"path":15,"stem":16},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation",{"title":18,"path":19,"stem":20},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F3.quickstart",false,{"title":23,"path":24,"stem":25,"children":26,"page":21},"Guide","\u002Fguide","2.guide",[27,31],{"title":28,"path":29,"stem":30},"Writing a template","\u002Fguide\u002Ftemplates","2.guide\u002F1.templates",{"title":32,"path":33,"stem":34},"The terox.json manifest","\u002Fguide\u002Fmanifest","2.guide\u002F2.manifest",{"title":36,"path":37,"stem":38,"children":39,"page":21},"Reference","\u002Freference","3.reference",[40],{"title":41,"path":42,"stem":43},"CLI reference","\u002Freference\u002Fcli","3.reference\u002F1.cli",{"title":45,"path":46,"stem":47,"children":48,"page":21},"About","\u002Fabout","4.about",[49,53],{"title":50,"path":51,"stem":52},"How Terox fits next to other tools","\u002Fabout\u002Fcomparison","4.about\u002F1.comparison",{"title":54,"path":55,"stem":56},"Status & roadmap","\u002Fabout\u002Fstatus","4.about\u002F2.status",{"id":58,"title":14,"body":59,"description":606,"extension":607,"meta":608,"navigation":388,"path":15,"seo":609,"stem":16,"__hash__":610},"docs\u002F1.getting-started\u002F2.installation.md",{"type":60,"value":61,"toc":593},"minimark",[62,75,80,93,118,129,133,144,162,171,175,188,191,253,267,282,290,293,308,315,342,345,418,422,425,457,471,484,488,491,510,516,520,589],[63,64,65,66,70,71,74],"p",{},"Terox is a single static binary that ships for Linux, macOS, and Windows on\nboth ",[67,68,69],"code",{},"amd64"," and ",[67,72,73],{},"arm64",". Pick whichever install method matches your\nplatform — they all give you the same binary.",[76,77,79],"h2",{"id":78},"with-homebrew-macos-and-linux","With Homebrew (macOS and Linux)",[63,81,82,83,92],{},"The fastest install on macOS and Linux is through the\n",[84,85,89],"a",{"href":86,"rel":87},"https:\u002F\u002Fgithub.com\u002Fweburz\u002Fhomebrew-tap",[88],"nofollow",[67,90,91],{},"weburz\u002Ftap"," Homebrew tap:",[94,95,100],"pre",{"className":96,"code":97,"language":98,"meta":99,"style":99},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","brew install weburz\u002Ftap\u002Fterox\n","bash","",[67,101,102],{"__ignoreMap":99},[103,104,107,111,115],"span",{"class":105,"line":106},"line",1,[103,108,110],{"class":109},"sBMFI","brew",[103,112,114],{"class":113},"sfazB"," install",[103,116,117],{"class":113}," weburz\u002Ftap\u002Fterox\n",[63,119,120,121,124,125,128],{},"That installs ",[67,122,123],{},"terox"," into the standard Homebrew prefix and adds it to\nyour ",[67,126,127],{},"PATH"," automatically.",[76,130,132],{"id":131},"with-scoop-windows","With Scoop (Windows)",[63,134,135,136,143],{},"On Windows, install through the\n",[84,137,140],{"href":138,"rel":139},"https:\u002F\u002Fgithub.com\u002Fweburz\u002Fscoop-bucket",[88],[67,141,142],{},"weburz\u002Fscoop-bucket"," Scoop\nbucket:",[94,145,149],{"className":146,"code":147,"language":148,"meta":99,"style":99},"language-powershell shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","scoop bucket add weburz https:\u002F\u002Fgithub.com\u002Fweburz\u002Fscoop-bucket\nscoop install weburz\u002Fterox\n","powershell",[67,150,151,156],{"__ignoreMap":99},[103,152,153],{"class":105,"line":106},[103,154,155],{},"scoop bucket add weburz https:\u002F\u002Fgithub.com\u002Fweburz\u002Fscoop-bucket\n",[103,157,159],{"class":105,"line":158},2,[103,160,161],{},"scoop install weburz\u002Fterox\n",[63,163,164,165,170],{},"If you do not have Scoop yet, follow the one-line install at\n",[84,166,169],{"href":167,"rel":168},"https:\u002F\u002Fscoop.sh",[88],"scoop.sh"," first.",[76,172,174],{"id":173},"direct-binary-download","Direct binary download",[63,176,177,178,183,184,187],{},"Every release attaches a prebuilt archive for each supported platform to\nthe ",[84,179,182],{"href":180,"rel":181},"https:\u002F\u002Fgithub.com\u002Fweburz\u002Fterox\u002Freleases\u002Flatest",[88],"GitHub releases page",".\nA ",[67,185,186],{},"checksums.txt"," next to the archives lets you verify the download.",[63,189,190],{},"Pick the archive that matches your OS and architecture, for example:",[94,192,194],{"className":96,"code":193,"language":98,"meta":99,"style":99},"# Linux on amd64\ncurl -L -o terox.tar.gz \\\n  https:\u002F\u002Fgithub.com\u002Fweburz\u002Fterox\u002Freleases\u002Flatest\u002Fdownload\u002Fterox_0.1.2_linux_amd64.tar.gz\ntar -xzf terox.tar.gz\nsudo mv terox \u002Fusr\u002Flocal\u002Fbin\u002F\n",[67,195,196,202,220,226,238],{"__ignoreMap":99},[103,197,198],{"class":105,"line":106},[103,199,201],{"class":200},"sHwdD","# Linux on amd64\n",[103,203,204,207,210,213,216],{"class":105,"line":158},[103,205,206],{"class":109},"curl",[103,208,209],{"class":113}," -L",[103,211,212],{"class":113}," -o",[103,214,215],{"class":113}," terox.tar.gz",[103,217,219],{"class":218},"sTEyZ"," \\\n",[103,221,223],{"class":105,"line":222},3,[103,224,225],{"class":113},"  https:\u002F\u002Fgithub.com\u002Fweburz\u002Fterox\u002Freleases\u002Flatest\u002Fdownload\u002Fterox_0.1.2_linux_amd64.tar.gz\n",[103,227,229,232,235],{"class":105,"line":228},4,[103,230,231],{"class":109},"tar",[103,233,234],{"class":113}," -xzf",[103,236,237],{"class":113}," terox.tar.gz\n",[103,239,241,244,247,250],{"class":105,"line":240},5,[103,242,243],{"class":109},"sudo",[103,245,246],{"class":113}," mv",[103,248,249],{"class":113}," terox",[103,251,252],{"class":113}," \u002Fusr\u002Flocal\u002Fbin\u002F\n",[63,254,255,256,259,260,263,264,266],{},"On Windows the archive is a ",[67,257,258],{},".zip"," containing ",[67,261,262],{},"terox.exe","; extract it and\nmove the executable somewhere on your ",[67,265,127],{},".",[268,269,271],"callout",{"icon":270},"i-lucide-info",[63,272,273,274,277,278,281],{},"Replace ",[67,275,276],{},"0.1.2"," in the URL with the version you want, or use\n",[67,279,280],{},"\u002Freleases\u002Flatest\u002Fdownload\u002F"," to always grab the newest stable build.",[76,283,285,286,289],{"id":284},"with-go-go-install","With Go (",[67,287,288],{},"go install",")",[63,291,292],{},"If you already have Go 1.23 or newer installed, you can install Terox\ndirectly from source:",[94,294,296],{"className":96,"code":295,"language":98,"meta":99,"style":99},"go install github.com\u002Fweburz\u002Fterox@latest\n",[67,297,298],{"__ignoreMap":99},[103,299,300,303,305],{"class":105,"line":106},[103,301,302],{"class":109},"go",[103,304,114],{"class":113},[103,306,307],{"class":113}," github.com\u002Fweburz\u002Fterox@latest\n",[309,310,312,313],"h3",{"id":311},"make-sure-the-binary-is-on-your-path","Make sure the binary is on your ",[67,314,127],{},[63,316,317,319,320,323,324,327,328,331,332,335,336,338,339,341],{},[67,318,288],{}," writes the binary to ",[67,321,322],{},"$(go env GOBIN)"," if ",[67,325,326],{},"GOBIN"," is set, or\n",[67,329,330],{},"$(go env GOPATH)\u002Fbin"," otherwise. On a typical Linux or macOS setup that's\n",[67,333,334],{},"~\u002Fgo\u002Fbin",". If that directory is not on your ",[67,337,127],{},", the ",[67,340,123],{}," command\nwill not be found.",[63,343,344],{},"Add it permanently to your shell config:",[94,346,348],{"className":96,"code":347,"language":98,"meta":99,"style":99},"# bash\necho 'export PATH=\"$PATH:$HOME\u002Fgo\u002Fbin\"' >> ~\u002F.bashrc\nsource ~\u002F.bashrc\n\n# zsh\necho 'export PATH=\"$PATH:$HOME\u002Fgo\u002Fbin\"' >> ~\u002F.zshrc\nsource ~\u002F.zshrc\n",[67,349,350,355,377,384,390,395,411],{"__ignoreMap":99},[103,351,352],{"class":105,"line":106},[103,353,354],{"class":200},"# bash\n",[103,356,357,361,365,368,371,374],{"class":105,"line":158},[103,358,360],{"class":359},"s2Zo4","echo",[103,362,364],{"class":363},"sMK4o"," '",[103,366,367],{"class":113},"export PATH=\"$PATH:$HOME\u002Fgo\u002Fbin\"",[103,369,370],{"class":363},"'",[103,372,373],{"class":363}," >>",[103,375,376],{"class":113}," ~\u002F.bashrc\n",[103,378,379,382],{"class":105,"line":222},[103,380,381],{"class":359},"source",[103,383,376],{"class":113},[103,385,386],{"class":105,"line":228},[103,387,389],{"emptyLinePlaceholder":388},true,"\n",[103,391,392],{"class":105,"line":240},[103,393,394],{"class":200},"# zsh\n",[103,396,398,400,402,404,406,408],{"class":105,"line":397},6,[103,399,360],{"class":359},[103,401,364],{"class":363},[103,403,367],{"class":113},[103,405,370],{"class":363},[103,407,373],{"class":363},[103,409,410],{"class":113}," ~\u002F.zshrc\n",[103,412,414,416],{"class":105,"line":413},7,[103,415,381],{"class":359},[103,417,410],{"class":113},[76,419,421],{"id":420},"building-from-source","Building from source",[63,423,424],{},"Clone the repository and build with the included Taskfile:",[94,426,428],{"className":96,"code":427,"language":98,"meta":99,"style":99},"git clone https:\u002F\u002Fgithub.com\u002Fweburz\u002Fterox.git\ncd terox\ntask build\n",[67,429,430,441,449],{"__ignoreMap":99},[103,431,432,435,438],{"class":105,"line":106},[103,433,434],{"class":109},"git",[103,436,437],{"class":113}," clone",[103,439,440],{"class":113}," https:\u002F\u002Fgithub.com\u002Fweburz\u002Fterox.git\n",[103,442,443,446],{"class":105,"line":158},[103,444,445],{"class":359},"cd",[103,447,448],{"class":113}," terox\n",[103,450,451,454],{"class":105,"line":222},[103,452,453],{"class":109},"task",[103,455,456],{"class":113}," build\n",[63,458,459,460,463,464,466,467,470],{},"The binary will be written to ",[67,461,462],{},".\u002Fbin\u002Fterox",". Move it onto your ",[67,465,127],{}," (for\nexample ",[67,468,469],{},"sudo mv .\u002Fbin\u002Fterox \u002Fusr\u002Flocal\u002Fbin\u002F",") or invoke it directly.",[63,472,473,474,479,480,483],{},"If you do not have ",[84,475,478],{"href":476,"rel":477},"https:\u002F\u002Ftaskfile.dev",[88],"Task"," installed, ",[67,481,482],{},"go build .","\nproduces the same binary without the embedded version metadata.",[76,485,487],{"id":486},"verify-the-install","Verify the install",[63,489,490],{},"Whichever method you used, confirm it worked:",[94,492,494],{"className":96,"code":493,"language":98,"meta":99,"style":99},"which terox\nterox version\n",[67,495,496,503],{"__ignoreMap":99},[103,497,498,501],{"class":105,"line":106},[103,499,500],{"class":359},"which",[103,502,448],{"class":113},[103,504,505,507],{"class":105,"line":158},[103,506,123],{"class":109},[103,508,509],{"class":113}," version\n",[63,511,512,515],{},[67,513,514],{},"terox version"," should print the version number, commit hash, and build\ndate for the binary you just installed.",[76,517,519],{"id":518},"updating","Updating",[521,522,523,536],"table",{},[524,525,526],"thead",{},[527,528,529,533],"tr",{},[530,531,532],"th",{},"Install method",[530,534,535],{},"Update command",[537,538,539,550,560,568,579],"tbody",{},[527,540,541,545],{},[542,543,544],"td",{},"Homebrew",[542,546,547],{},[67,548,549],{},"brew upgrade weburz\u002Ftap\u002Fterox",[527,551,552,555],{},[542,553,554],{},"Scoop",[542,556,557],{},[67,558,559],{},"scoop update weburz\u002Fterox",[527,561,562,565],{},[542,563,564],{},"Direct download",[542,566,567],{},"Re-download the latest archive and replace the binary",[527,569,570,574],{},[542,571,572],{},[67,573,288],{},[542,575,576],{},[67,577,578],{},"go install github.com\u002Fweburz\u002Fterox@latest",[527,580,581,584],{},[542,582,583],{},"Built from source",[542,585,586],{},[67,587,588],{},"git pull && task build",[590,591,592],"style",{},"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 .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 pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}",{"title":99,"searchDepth":106,"depth":158,"links":594},[595,596,597,598,603,604,605],{"id":78,"depth":158,"text":79},{"id":131,"depth":158,"text":132},{"id":173,"depth":158,"text":174},{"id":284,"depth":158,"text":599,"children":600},"With Go (go install)",[601],{"id":311,"depth":222,"text":602},"Make sure the binary is on your PATH",{"id":420,"depth":158,"text":421},{"id":486,"depth":158,"text":487},{"id":518,"depth":158,"text":519},"Install Terox with Homebrew, Scoop, a direct binary download, or via Go.","md",{},{"title":14,"description":606},"MRvGtbFLq3LKNm9ysmtu5FLW8oSYhzhQ1uinGQ4Mbzw",1779617132661]