Devour/devour_data/docs/zerops.json

{
  "id": "e4fa1e1be19ccc0ce2b95b05",
  "source": "solid:signals",
  "type": "github-document",
  "title": "zerops",
  "content": "---\ntitle: Zerops\norder: 7\nmainNavExclude: true\nuse_cases: \u003e-\n  deploying solid apps, static site hosting, ssr deployment, node.js hosting,\n  production deployment\ntags:\n  - deployment\n  - hosting\n  - zerops\n  - static\n  - ssr\n  - node.js\n  - production\nversion: '1.0'\ndescription: \u003e-\n  Deploy SolidStart apps to Zerops cloud platform with support for both static\n  sites and SSR Node.js applications in production.\n---\n\n[Zerops](https://zerops.io) is a dev-first cloud platform that can be used to deploy both Static and SSR Solid Node.js Apps.\n\nFor additional one-to-one support, details, and features, you can join the [Zerops Discord server](https://discord.gg/xxzmJSDKPT) and [visit the Zerops Docs](https://docs.zerops.io).\n\nDeploy and test Zerops Solid recipes with one click:\n- [Deploy Solid Node.js \u0026 Static Together](https://app.zerops.io/recipe/solidjs) - [Node.js](https://github.com/zeropsio/recipe-solidjs-nodejs) and [Static](https://github.com/zeropsio/recipe-solidjs-static).\n- [Deploy Solid Node.js](https://app.zerops.io/recipe/solidjs-nodejs) - [Source Repository](https://github.com/zeropsio/recipe-solidjs-nodejs)\n- [Deploy Solid Static](https://app.zerops.io/recipe/solidjs-static) - [Source Repository](https://github.com/zeropsio/recipe-solidjs-static)\n\n## Setting up an Account on Zerops\n\n1. Go to [Zerops Registration](https://app.zerops.io/registration) and sign up using GitHub, GitLab, or just your email.\n\n## Setting up your Project Infrastructure\n\nThere are two ways to set up a Zerops project and a service:\n\n#### Using Project Add Wizard (GUI)\n\n1. Go to your [Zerops dashboard](https://app.zerops.io/dashboard/projects).\n2. Add a new project using your sidebar. If you're in compact mode, click on your profile and then \"Add new project.\"\n3. You'll be redirected to a page where you can choose a service.\n\n##### For Static:\n1. Choose Static.\n2. Scroll down and change the hostname to your preference.\n3. Scroll down and click on the \"Add New Static\" button.\n\n##### For SSR - Node.js:\n1. Choose `Node.js` and select `version 20`.\n2. Scroll down and change the hostname to your preference.\n3. Scroll down and click on the \"Add New Node.js\" button.\n\n#### Using Project Import YAML\n\n**Note**: This is only used for project creation using YAML on the web interface—no need to add it to the project.\n\n1. Go to your [Zerops dashboard](https://app.zerops.io/dashboard/projects) and click on your profile icon if you are a new user. If not, check your sidebar and click on `Import Project`.\n\n##### Static:\n```yaml\nproject:\n  name: recipe-solidjs\n\nservices:\n  - hostname: app\n    type: static\n    enableSubdomainAccess: true\n```\n\n##### SSR - Node.js:\n```yaml\nproject:\n  name: recipe-solidjs\n\nservices:\n  - hostname: app\n    type: nodejs@20\n    enableSubdomainAccess: true\n```\n\n## Add zerops.yml to your repository\nThe `zerops.yml` configuration file is used to tell Zerops how to build and run your application, it should be placed to the root of your appplication's repository.\n\nExample for **SSR (Server-Side Rendering)** Apps:\n\nSet up the `zerops.yml` file in the root of your SSR project. Make sure the setup parameter's value is the same as the hostname of the service.\n\n```yaml\nzerops:\n  - setup: app\n    build:\n      base: nodejs@latest\n      buildCommands:\n        - pnpm i\n        - pnpm build\n      deployFiles:\n        - .output\n        - node_modules\n        - public\n        - package.json\n    run:\n      base: nodejs@latest\n      ports:\n        - port: 3000\n          httpSupport: true\n      start: pnpm start\n```\n\nExample for **SSG (Static Site Generation)** Apps:\n\nSet up the `zerops.yml` file in the root of your SSG project. Make sure the setup parameter's value is the same as the hostname of the service.\n\n```yaml\nzerops:\n  - setup: app\n    build:\n      base: nodejs@latest\n      buildCommands:\n        - pnpm i\n        - pnpm build\n      deployFiles:\n        - dist/~\n    run:\n      base: static\n```\nPush the changes to your GitHub/GitLab repository (necessary if you are planning to use GitHub/GitLab).\n\n## Deploying your apps\n\n### Triggering the pipeline automatically by connecting Github/Gitlab repository\nYou can push your project by [Triggering the pipeline using Zerops CLI](#triggering-the-pipeline-using-githubgitlab) or by connecting the app service with your [GitHub](https://docs.zerops.io/references/github-integration/) / [GitLab](https://docs.zerops.io/references/gitlab-integration) repository from inside the service detail.\n\n### Triggering the pipeline manually using Zerops CLI\n\nTo download the zCLI binary directly, use [zCLI/releases](https://github.com/zeropsio/zcli/releases) or:\n1. Install the Zerops CLI using Terminal.\n\nLinux/MacOS\n\n```bash\ncurl -L https://zerops.io/zcli/install.sh | sh\n```\n\nWindows\n\n```powershell\nirm https://zerops.io/zcli/install.ps1 | iex\n```\n\nNpm\n\n```package-install-global\n@zerops/zcli\n```\n\n2. Open Settings \u003e [Access Token Management](https://app.zerops.io/settings/token-management) in the Zerops app and generate a new access token.\n3. Log in using your access token with the following command:\n```bash\nzcli login \u003ctoken\u003e\n```\n4. Navigate to the root of your app (where zerops.yml is located) and run the following command in Terminal to trigger the deploy:\n```bash\nzcli push\n```\n\nCheck the official docs if you need more advanced use-cases for [Zerops Docs](http://docs.zerops.io/).",
  "url": "https://github.com/solidjs/solid-docs/blob/HEAD/src/routes/guides/deployment-options/zerops.mdx",
  "metadata": {
    "path": "src/routes/guides/deployment-options/zerops.mdx",
    "repo": "solidjs/solid-docs",
    "repo_url": "https://github.com/solidjs/solid-docs.git",
    "size": 5385,
    "source_type": "github"
  },
  "hash": "32639561a58b2b5c64d81f56c388f1cae54016a6cccff6d8e75e34f40cac9e3b",
  "timestamp": "2026-02-23T11:43:00.187682668+01:00"
}