Getting Started

Show TL;DR - all commands

curl -sSL https://get.neterial.cloud/cli.sh | bash
neterial auth login
neterial ssh-key add --auto-detect
neterial provider init hcloud  # or: neterial provider init aws
neterial infra create vm --cloud hcloud  # or: --cloud aws

# In your app repo:
git remote add neterial git@git.<hostname>.neterial.app:<app>.git
git push neterial main

1. Install CLI

curl -sSL https://get.neterial.cloud/cli.sh | bash

2. Log in

neterial auth login

New users can create an account during login.

3. Add your SSH key

neterial ssh-key add --auto-detect

4. Connect your cloud

Hetzner Cloud
AWS

neterial provider init hcloud

Or connect via UI: Connect Hetzner Cloud

neterial provider init aws

Or connect via UI: Connect AWS

Verify that the cloud is connected:

neterial provider list

5. Create a VM

Hetzner Cloud
AWS

neterial infra create vm --cloud hcloud

neterial infra create vm --cloud aws

Example output:

Creating VM "default" in hel1 on hcloud...
Waiting for the VM to be ready.............
VM is ready (k3s installed)
Access your cluster:

kubectl --context default-neterial-admin@default-neterial cluster-info

Deploy apps with git push:

  git remote add neterial git@git.01kfybgvn6ewjrgsrzkseqcgpt.neterial.app:<your-app>.git
  git push neterial main

6. Deploy your app

Go to your app’s repository.

Show Don't have a repo? Create a sample app

npx create-next-app@latest my-app
cd my-app

Copy the git remote command from the output and run it in your repository:

git remote add neterial git@git.<your-hostname>.neterial.app:<your-app>.git

Push to deploy:

git push neterial main

You will see the URL in the output:

remote: Deployed! Application URL:
remote: -------------------------------------------------------
remote:   https://hello.01kfxd43vxe0ran5xhwjtd4m5n.neterial.app
remote: -------------------------------------------------------

Open the URL to see your app running.

Next step

For deploying with Kubernetes manifests instead of git push, see Deploy App to k8s.

Cloud Providers

Guides

CLI

Getting Started

1. Install CLI

2. Log in

3. Add your SSH key

4. Connect your cloud

5. Create a VM

6. Deploy your app

Next step

​1. Install CLI

​2. Log in

​3. Add your SSH key

​4. Connect your cloud

​5. Create a VM

​6. Deploy your app

​Next step

1. Install CLI

2. Log in

3. Add your SSH key

4. Connect your cloud

5. Create a VM

6. Deploy your app

Next step