# Gleam Getting Started


[Gleam ↗](https://gleam.org/en) 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 ↗](https://github.com/zeropsio/recipe-gleam), a **_recipe_**, containing the most simple Gleam 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 Gleam app running in Zerops — as few libraries as possible,
  just a simple endpoint with connect, read and write to a Zerops PostgreSQL database.

  [Deploy "gleam" recipe on Zerops](https://app.zerops.io/recipe/?lf=gleam)

1. Log in/sign up to [Zerops GUI ↗](https://app.zerops.io)

2. In the **Projects** box click on **Import a project** and paste in the following YAML config ([source ↗](https://github.com/zeropsio/recipe-gleam/blob/main/zerops-project-import.yaml)):

```yaml
project:
  name: recipe-gleam
  tags:
    - zerops-recipe

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

  - 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! :star: 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://api-808-3000.prg1.zerops.app`.
2. Click or the `subdomain` URL to open it in a browser and you should see

```
{"message":"This is a simple Gleam application running in Zerops.io, each request adds an entry to the PostgreSQL database and returns a count. See the source repository (https://github.com/zeropsio/recipe-gleam) for more information.","newEntry":"e64be640-d6c2-4be8-93ac-d1e40e56fa06","count":1}
```

:::tip
Do you have any questions? Check the step-by-step tutorial, browse the documentation and join our **[Discord](https://discord.com/invite/WDvCZ54)** 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:

- [Care for details?](/gleam/how-to/create) — Dive in all Zerops has to offer for your Gleam application.
- [Gleam recipes](https://github.com/zeropsio?q=gleam&type=all&language=&sort=) — Get inspired by already existing repositories, ready to be imported to Zerops.

## Feature Highlights

- [Create Gleam service](/gleam/how-to/create) — Start with creating a Gleam service using GUI or zCLI.
- [Zerops.yaml](/gleam/how-to/build-pipeline#add-zeropsyaml-to-your-repository) — See a full example of zerops.yaml file to create your own app.
- [Scaling configuration](/gleam/how-to/scaling) — Set up scaling of your Gleam application so that it runs smoothly while using only necessary resources.

{" "}

- [Customize build environment](/gleam/how-to/build-process#customize-build-environment)
- [Customize runtime environment](/gleam/how-to/customize-runtime)

## 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](/gleam/faq) — Most common questions in one place.
- [Discord](https://discord.com/invite/WDvCZ54) — Join our core team and Zerops community on Discord. Ask questions and share your tips with other members.

## Popular Guides

- [zCLI](/references/cli) — Get even more out of Zerops with the zCLI command line tool.
- [Zerops VPN](/references/networking/vpn) — Connect to your services easily with Zerops VPN.