[{"data":1,"prerenderedAt":543},["ShallowReactive",2],{"navigation":3,"/docs/installation/install-macos/":285,"/docs/installation/install-macos/-surround":541},[4],{"title":5,"path":6,"stem":7,"children":8},"Introduction","/docs","docs/1.index",[9,10,36,53,70,83,100,121,138,155,176],{"title":5,"path":6,"stem":7},{"title":11,"path":12,"stem":13,"children":14,"page":35},"Installation","/docs/installation","docs/1.installation",[15,19,23,27,31],{"title":16,"path":17,"stem":18},"Install to macOS","/docs/installation/install-macos","docs/1.installation/1.install-macos",{"title":20,"path":21,"stem":22},"Install to Windows","/docs/installation/install-windows","docs/1.installation/2.install-windows",{"title":24,"path":25,"stem":26},"Install to Linux","/docs/installation/install-linux","docs/1.installation/3.install-linux",{"title":28,"path":29,"stem":30},"Install via Composer","/docs/installation/install-composer","docs/1.installation/4.install-composer",{"title":32,"path":33,"stem":34},"Install via NPM/Yarn","/docs/installation/install-npm-yarn","docs/1.installation/5.install-npm-yarn",false,{"title":37,"path":38,"stem":39,"children":40,"page":35},"Community","/docs/community","docs/11.community",[41,45,49],{"title":42,"path":43,"stem":44},"Get Help","/docs/community/get-help","docs/11.community/1.get-help",{"title":46,"path":47,"stem":48},"Testing New Releases","/docs/community/testing","docs/11.community/2.testing",{"title":50,"path":51,"stem":52},"Contributing","/docs/community/contributing","docs/11.community/3.contributing",{"title":54,"path":55,"stem":56,"children":57,"page":35},"Getting Started","/docs/getting-started","docs/2.getting-started",[58,62,66],{"title":59,"path":60,"stem":61},"How Spin Works","/docs/getting-started/how-spin-works","docs/2.getting-started/1.how-spin-works",{"title":63,"path":64,"stem":65},"Create a New Project with Spin","/docs/getting-started/create-a-new-project-with-spin","docs/2.getting-started/2.create-a-new-project-with-spin",{"title":67,"path":68,"stem":69},"Add Spin to an Existing Project","/docs/getting-started/add-spin-to-an-existing-project","docs/2.getting-started/3.add-spin-to-an-existing-project",{"title":71,"path":72,"stem":73,"children":74,"page":35},"Development Environment","/docs/development-environment","docs/3.development-environment",[75,79],{"title":76,"path":77,"stem":78},"Starting Up Your Development Environment","/docs/development-environment/starting-up-your-development-environment","docs/3.development-environment/1.starting-up-your-development-environment",{"title":80,"path":81,"stem":82},"Running Commands in Development","/docs/development-environment/running-commands-in-development","docs/3.development-environment/2.running-commands-in-development",{"title":84,"path":85,"stem":86,"children":87,"page":35},"Server Configuration","/docs/server-configuration","docs/4.server-configuration",[88,92,96],{"title":89,"path":90,"stem":91},"Server Requirements","/docs/server-configuration/server-requirements","docs/4.server-configuration/1.server-requirements",{"title":93,"path":94,"stem":95},"Server Configuration Basics","/docs/server-configuration/server-configuration-basics","docs/4.server-configuration/2.server-configuration-basics",{"title":97,"path":98,"stem":99},".spin.yml Usage","/docs/server-configuration/spin-yml-usage","docs/4.server-configuration/3.spin-yml-usage",{"title":101,"path":102,"stem":103,"children":104,"page":35},"Providers","/docs/providers","docs/5.providers",[105,109,113,117],{"title":106,"path":107,"stem":108},"DigitalOcean","/docs/providers/digitalocean","docs/5.providers/0.digitalocean",{"title":110,"path":111,"stem":112},"Hetzner","/docs/providers/hetzner","docs/5.providers/0.hetzner",{"title":114,"path":115,"stem":116},"Vultr","/docs/providers/vultr","docs/5.providers/0.vultr",{"title":118,"path":119,"stem":120},"Use Any Host","/docs/providers/use-any-host","docs/5.providers/99.use-any-host",{"title":122,"path":123,"stem":124,"children":125,"page":35},"Deployment","/docs/deployment","docs/6.deployment",[126,130,134],{"title":127,"path":128,"stem":129},"Choosing a Deployment Strategy","/docs/deployment/choosing-a-deployment-strategy","docs/6.deployment/1.choosing-a-deployment-strategy",{"title":131,"path":132,"stem":133},"Automated Deployments with GitHub Actions","/docs/deployment/automated-deployments-with-github-actions","docs/6.deployment/2.automated-deployments-with-github-actions",{"title":135,"path":136,"stem":137},"Using \"spin deploy\"","/docs/deployment/using-spin-deploy","docs/6.deployment/3.using-spin-deploy",{"title":139,"path":140,"stem":141,"children":142,"page":35},"Server Access","/docs/server-access","docs/7.server-access",[143,147,151],{"title":144,"path":145,"stem":146},"Connecting to Your Server","/docs/server-access/connecting-to-your-server","docs/7.server-access/1.connecting-to-your-server",{"title":148,"path":149,"stem":150},"Troubleshooting Your Application","/docs/server-access/troubleshooting-your-application","docs/7.server-access/2.troubleshooting-your-application",{"title":152,"path":153,"stem":154},"Updating Your Server","/docs/server-access/updating-your-server","docs/7.server-access/3.updating-your-server",{"title":156,"path":157,"stem":158,"children":159,"page":35},"Advanced","/docs/advanced","docs/8.advanced",[160,164,168,172],{"title":161,"path":162,"stem":163},"Generating a Secure SSH Key","/docs/advanced/generating-a-secure-ssh-key","docs/8.advanced/2.generating-a-secure-ssh-key",{"title":165,"path":166,"stem":167},"Adding Other Services","/docs/advanced/adding-other-services","docs/8.advanced/3.adding-other-services",{"title":169,"path":170,"stem":171},"Create your own Spin Template","/docs/advanced/create-your-own-template","docs/8.advanced/99.create-your-own-template",{"title":173,"path":174,"stem":175},"Migrating from Spin v2 to v3","/docs/advanced/migrating-from-spin-v2-to-v3","docs/8.advanced/migrating-from-spin-v2-to-v3",{"title":177,"path":178,"stem":179,"children":180,"page":35},"Command Reference","/docs/command-reference","docs/9.command-reference",[181,185,189,193,197,201,205,209,213,217,221,225,229,233,237,241,245,249,253,257,261,265,269,273,277,281],{"title":182,"path":183,"stem":184},"base64","/docs/command-reference/base64","docs/9.command-reference/base64",{"title":186,"path":187,"stem":188},"build","/docs/command-reference/build","docs/9.command-reference/build",{"title":190,"path":191,"stem":192},"configure","/docs/command-reference/configure","docs/9.command-reference/configure",{"title":194,"path":195,"stem":196},"debug","/docs/command-reference/debug","docs/9.command-reference/debug",{"title":198,"path":199,"stem":200},"deploy","/docs/command-reference/deploy","docs/9.command-reference/deploy",{"title":202,"path":203,"stem":204},"down","/docs/command-reference/down","docs/9.command-reference/down",{"title":206,"path":207,"stem":208},"exec","/docs/command-reference/exec","docs/9.command-reference/exec",{"title":210,"path":211,"stem":212},"gh","/docs/command-reference/gh","docs/9.command-reference/gh",{"title":214,"path":215,"stem":216},"help","/docs/command-reference/help","docs/9.command-reference/help",{"title":218,"path":219,"stem":220},"init","/docs/command-reference/init","docs/9.command-reference/init",{"title":222,"path":223,"stem":224},"kill","/docs/command-reference/kill","docs/9.command-reference/kill",{"title":226,"path":227,"stem":228},"latest","/docs/command-reference/latest","docs/9.command-reference/latest",{"title":230,"path":231,"stem":232},"logs","/docs/command-reference/logs","docs/9.command-reference/logs",{"title":234,"path":235,"stem":236},"maintain","/docs/command-reference/maintain","docs/9.command-reference/maintain",{"title":238,"path":239,"stem":240},"mkpasswd","/docs/command-reference/mkpasswd","docs/9.command-reference/mkpasswd",{"title":242,"path":243,"stem":244},"new","/docs/command-reference/new","docs/9.command-reference/new",{"title":246,"path":247,"stem":248},"provision","/docs/command-reference/provision","docs/9.command-reference/provision",{"title":250,"path":251,"stem":252},"prune","/docs/command-reference/prune","docs/9.command-reference/prune",{"title":254,"path":255,"stem":256},"ps","/docs/command-reference/ps","docs/9.command-reference/ps",{"title":258,"path":259,"stem":260},"pull","/docs/command-reference/pull","docs/9.command-reference/pull",{"title":262,"path":263,"stem":264},"run","/docs/command-reference/run","docs/9.command-reference/run",{"title":266,"path":267,"stem":268},"stop","/docs/command-reference/stop","docs/9.command-reference/stop",{"title":270,"path":271,"stem":272},"up","/docs/command-reference/up","docs/9.command-reference/up",{"title":274,"path":275,"stem":276},"update","/docs/command-reference/update","docs/9.command-reference/update",{"title":278,"path":279,"stem":280},"vault","/docs/command-reference/vault","docs/9.command-reference/vault",{"title":282,"path":283,"stem":284},"version","/docs/command-reference/version","docs/9.command-reference/version",{"id":286,"title":16,"body":287,"canonical":532,"description":533,"extension":534,"layout":535,"meta":536,"navigation":485,"path":17,"seo":539,"stem":18,"__hash__":540},"docs/docs/1.installation/1.install-macos.md",{"type":288,"value":289,"toc":525},"minimark",[290,302,307,310,320,326,336,375,387,393,397,403,412,454,461,501,505,508,521],[291,292,293],"lead-p",{},[294,295,296,297,301],"p",{},"Spin easily runs on any macOS machine that runs Docker Desktop. Getting started is as simple as installing Docker Desktop, then running a single command to install ",[298,299,300],"code",{},"spin",".",[303,304,306],"h2",{"id":305},"install-docker-desktop","Install Docker Desktop",[294,308,309],{},"MacOS does not ship with Docker by default. To get Docker installed, you will need \"Docker Desktop\", which is the official desktop tool developed by Docker.",[294,311,312],{},[313,314,319],"a",{"href":315,"rel":316,"target":318},"https://docs.docker.com/desktop/mac/install/",[317],"nofollow","_blank","Learn how to install Docker Desktop →",[303,321,323,324],{"id":322},"download-and-install-spin","Download and install ",[298,325,300],{},[294,327,328,329,331,332],{},"Once Docker is installed, you are now ready to install ",[298,330,300],{},". Run the installer with this simple command in your terminal. ",[333,334,335],"strong",{},"No root permissions required.",[337,338,344],"pre",{"className":339,"code":340,"filename":341,"language":342,"meta":343,"style":343},"language-bash shiki shiki-themes material-theme-lighter github-dark github-dark","bash -c \"$(curl -fsSL https://raw.githubusercontent.com/serversideup/spin/main/tools/install.sh)\"\n","Install spin to your machine (no root permissions required)","bash","",[298,345,346],{"__ignoreMap":343},[347,348,351,354,358,362,365,368,372],"span",{"class":349,"line":350},"line",1,[347,352,342],{"class":353},"soiBB",[347,355,357],{"class":356},"sSJ72"," -c",[347,359,361],{"class":360},"sF_wb"," \"$(",[347,363,364],{"class":353},"curl",[347,366,367],{"class":356}," -fsSL",[347,369,371],{"class":370},"s0vBq"," https://raw.githubusercontent.com/serversideup/spin/main/tools/install.sh",[347,373,374],{"class":360},")\"\n",[294,376,377,378,382,383,386],{},"The above script will install spin at the ",[379,380,381],"em",{},"user"," level in ",[298,384,385],{},"~/.spin",", using less than 300KB of storage.",[388,389,390],"note",{},[294,391,392],{},"Spin will prompt you if you want Spin to modify your PATH variable. If you press \"Yes\" follow the instructions on the screen. If you press \"No\" you will need to manually add Spin to your PATH.",[303,394,396],{"id":395},"configuring-your-path-variable-manually","Configuring your PATH variable manually",[294,398,399,400,402],{},"If you did not add ",[298,401,300],{}," to your PATH during the installation, you can manually add it to your PATH by adding this to your shell profile:",[388,404,405],{},[294,406,407,408,411],{},"Run ",[298,409,410],{},"echo $0"," in your terminal to figure out which shell you are using.",[337,413,416],{"className":339,"code":414,"filename":415,"language":342,"meta":343,"style":343},"# Add this to `~/.zshrc` or `~/.bash_profile`\nexport PATH=\"$HOME/.spin/bin:$PATH\"\n","Add spin to your path",[298,417,418,424],{"__ignoreMap":343},[347,419,420],{"class":349,"line":350},[347,421,423],{"class":422},"sutJx","# Add this to `~/.zshrc` or `~/.bash_profile`\n",[347,425,427,431,435,439,442,445,448,451],{"class":349,"line":426},2,[347,428,430],{"class":429},"sFsEu","export",[347,432,434],{"class":433},"sMo7A"," PATH",[347,436,438],{"class":437},"sFfmW","=",[347,440,441],{"class":360},"\"",[347,443,444],{"class":433},"$HOME",[347,446,447],{"class":370},"/.spin/bin:",[347,449,450],{"class":433},"$PATH",[347,452,453],{"class":360},"\"\n",[294,455,456,457,460],{},"In order to apply the changes to your current terminal session, you will need to run the ",[298,458,459],{},"source"," command.",[337,462,465],{"className":339,"code":463,"filename":464,"language":342,"meta":343,"style":343},"# If you're using ZSH\nsource ~/.zshrc\n\n# If you're using Bash\nsource ~/.bash_profile\n","Use the \"source\" command to apply your profile changes immediately",[298,466,467,472,480,487,493],{"__ignoreMap":343},[347,468,469],{"class":349,"line":350},[347,470,471],{"class":422},"# If you're using ZSH\n",[347,473,474,477],{"class":349,"line":426},[347,475,459],{"class":476},"sUkpR",[347,478,479],{"class":370}," ~/.zshrc\n",[347,481,483],{"class":349,"line":482},3,[347,484,486],{"emptyLinePlaceholder":485},true,"\n",[347,488,490],{"class":349,"line":489},4,[347,491,492],{"class":422},"# If you're using Bash\n",[347,494,496,498],{"class":349,"line":495},5,[347,497,459],{"class":476},[347,499,500],{"class":370}," ~/.bash_profile\n",[303,502,504],{"id":503},"validate-its-working","Validate it's working",[294,506,507],{},"You should be able to run this and get a result 🥳",[337,509,512],{"className":339,"code":510,"filename":511,"language":342,"meta":343,"style":343},"spin version\n","Confirm spin is working correctly by getting the version",[298,513,514],{"__ignoreMap":343},[347,515,516,518],{"class":349,"line":350},[347,517,300],{"class":353},[347,519,520],{"class":370}," version\n",[522,523,524],"style",{},"html pre.shiki code .soiBB, html code.shiki .soiBB{--shiki-light:#E2931D;--shiki-default:#B392F0;--shiki-dark:#B392F0}html pre.shiki code .sSJ72, html code.shiki .sSJ72{--shiki-light:#91B859;--shiki-default:#79B8FF;--shiki-dark:#79B8FF}html pre.shiki code .sF_wb, html code.shiki .sF_wb{--shiki-light:#39ADB5;--shiki-default:#9ECBFF;--shiki-dark:#9ECBFF}html pre.shiki code .s0vBq, html code.shiki .s0vBq{--shiki-light:#91B859;--shiki-default:#9ECBFF;--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 .sFsEu, html code.shiki .sFsEu{--shiki-light:#9C3EDA;--shiki-default:#F97583;--shiki-dark:#F97583}html pre.shiki code .sMo7A, html code.shiki .sMo7A{--shiki-light:#90A4AE;--shiki-default:#E1E4E8;--shiki-dark:#E1E4E8}html pre.shiki code .sFfmW, html code.shiki .sFfmW{--shiki-light:#39ADB5;--shiki-default:#F97583;--shiki-dark:#F97583}html pre.shiki code .sUkpR, html code.shiki .sUkpR{--shiki-light:#6182B8;--shiki-default:#79B8FF;--shiki-dark:#79B8FF}",{"title":343,"searchDepth":426,"depth":426,"links":526},[527,528,530,531],{"id":305,"depth":426,"text":306},{"id":322,"depth":426,"text":529},"Download and install spin",{"id":395,"depth":426,"text":396},{"id":503,"depth":426,"text":504},"https://serversideup.net/open-source/spin/docs/installation/install-macos","Learn how to install Spin on macOS. No root access required.","md","docs",{"head":537},{"title":538},"Install to macOS - Spin by Server Side Up",{"title":16,"description":533},"O74ov0mpXLueQgquOWnhfN0vFQ5lTvfFThYSRKllmpw",[542,542],null,1769465044055]