Node.js Getting Started

Node.js ↗ is an asynchronous event-driven JavaScript runtime, which is designed to build scalable network applications.

As said, there is no need for coding yet, we have created a Github repository ↗, a recipe, containing the most simple Node.js web application. The repo will be used as a source from which the app will be built.

🚀Feel free to deploy the recipe yourself

This is the most bare-bones example of Node.js app running on Zerops — as few libraries as possible, just a simple endpoint with connect, read and write to a Zerops PostgreSQL database.

1. Log in/sign up to Zerops GUI ↗

2. In the Projects box click on Import a project and paste in the following yml config (source ↗):

project:
  name: recipe-nodejs
  tags:
    - zerops-recipe

services:
  - hostname: api
    type: nodejs@20
    enableSubdomainAccess: true
    buildFromGit: https://github.com/zeropsio/recipe-nodejs

  - hostname: db
    type: postgresql@16
    mode: NON_HA
    priority: 1

3. Click on Import project and wait until all pipelines have finished.

That's it, your application is now up and running! ⭐ Let's check it works:

1. A subdomain should have been enabled and visible in the project's IP addressed & Public Routing Overview box. Its format should look similar to this https://helloworld-24-8080.prg1.zerops.app.
2. Click or the subdomain URL to open it in a browser and you should see

Hello, World!

Tip

Do you have any questions? Check the step-by-step tutorial, browse the documentation and join our Discord community to get help from our team and other members.

How to start

It doesn't matter whether it's your first curious introduction to Zerops, you have already mastered the basics and are looking for a tiny detail or inspiration. Below, choose a section that fits your needs:

New to Zerops?

There is no better way to start than to try it yourself.

Care for details?

Dive in all Zerops has to offer for your Node.js application.

Node.js recipes

Get inspired by already existing repositories, ready to be imported to Zerops.

Feature Highlights

Create Node.js service

Start with creating a Node.js service using GUI or zCLI.

zerops.yml

See a full example of zerops.yml file to create your own app.

Scaling configuration

Set up scaling of your Node.js application so that it runs smoothly while using only necessary resources.

Customize build environment

Customize runtime environment

When in doubt, reach out

Don't know how to start or got stuck during the process? You might not be the first one, visit the FAQ section to find out.

In case you haven't found an answer (and also if you have), we and our community are looking forward to hearing from you on Discord.

Have you build something that others might find useful? Don't hesitate to share your knowledge!

FAQ

Most common questions in one place.

Discord

Join our core team and Zerops community on Discord. Ask questions and share your tips with other members.

Popular Guides

zCLI

Get even more out of Zerops with the zCLI command line tool.

Zerops VPN

Connect to your services easily with Zerops VPN.