Zerops

Zerops is a dev-first cloud platform that can be used to deploy both Static and SSR Solid Node.js Apps.

For additional one-to-one support, details, and features, you can join the Zerops Discord server and visit the Zerops Docs.

Deploy and test Zerops Solid recipes with one click:

• Deploy Solid Node.js & Static Together - Node.js and Static.
• Deploy Solid Node.js - Source Repository
• Deploy Solid Static - Source Repository

Setting up an Account on Zerops

1. Go to Zerops Registration and sign up using GitHub, GitLab, or just your email.

Setting up your Project Infrastructure

There are two ways to set up a Zerops project and a service:

Using Project Add Wizard (GUI)

1. Go to your Zerops dashboard.
2. Add a new project using your sidebar. If you're in compact mode, click on your profile and then "Add new project."
3. You'll be redirected to a page where you can choose a service.

For Static:

1. Choose Static.
2. Scroll down and change the hostname to your preference.
3. Scroll down and click on the "Add New Static" button.

For SSR - Node.js:

1. Choose Node.js and select version 20.
2. Scroll down and change the hostname to your preference.
3. Scroll down and click on the "Add New Node.js" button.

Using Project Import YAML

Note: This is only used for project creation using YAML on the web interface—no need to add it to the project.

1. Go to your Zerops dashboard and click on your profile icon if you are a new user. If not, check your sidebar and click on Import Project.

Static:

project:
  name: recipe-solidjs

services:
  - hostname: app
    type: static
    enableSubdomainAccess: true

SSR - Node.js:

project:
  name: recipe-solidjs

services:
  - hostname: app
    type: nodejs@20
    enableSubdomainAccess: true

Add zerops.yml to your repository

The 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.

Example for SSR (Server-Side Rendering) Apps:

Set 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.

zerops:
  - setup: app
    build:
      base: nodejs@latest
      buildCommands:
        - pnpm i
        - pnpm build
      deployFiles:
        - .output
        - node_modules
        - public
        - package.json
    run:
      base: nodejs@latest
      ports:
        - port: 3000
          httpSupport: true
      start: pnpm start

Example for SSG (Static Site Generation) Apps:

Set 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.

zerops:
  - setup: app
    build:
      base: nodejs@latest
      buildCommands:
        - pnpm i
        - pnpm build
      deployFiles:
        - dist/~
    run:
      base: static

Push the changes to your GitHub/GitLab repository (necessary if you are planning to use GitHub/GitLab).

Deploying your apps

Triggering the pipeline automatically by connecting Github/Gitlab repository

You can push your project by Triggering the pipeline using Zerops CLI or by connecting the app service with your GitHub / GitLab repository from inside the service detail.

Triggering the pipeline manually using Zerops CLI

To download the zCLI binary directly, use zCLI/releases or:

1. Install the Zerops CLI using Terminal.

Linux/MacOS

curl -L https://zerops.io/zcli/install.sh | sh

Windows

irm https://zerops.io/zcli/install.ps1 | iex

Npm

2. Open Settings > Access Token Management in the Zerops app and generate a new access token.
3. Log in using your access token with the following command:

zcli login <token>

4. Navigate to the root of your app (where zerops.yml is located) and run the following command in Terminal to trigger the deploy:

zcli push

Check the official docs if you need more advanced use-cases for Zerops Docs.