Skip to main content
Command-line interface for Neterial services.

​
Installation

Linux, macOS (brew), and Windows WSL: 
curl -sSL https://get.neterial.cloud/cli.sh | bash

Read Installation Details

Read INSTALL.md for details and alternative ways to install.

​
Quick start

# Login
neterial auth login

# Add your SSH key (for git push deployments)
neterial ssh-key add --auto-detect

# Connect your cloud (aws or hcloud)
neterial provider init hcloud

# Create your first VM
neterial infra create vm --cloud hcloud
Now you can deploy your apps using git push or use your VM as a Kubernetes cluster.

​
Authentication

Login to your Neterial account: 
neterial auth login
Logout: 
neterial auth logout

​
Cloud providers

Check your connected clouds: 
neterial provider list
You need to have a Hetzner Cloud account. If you don’t have one yet, you can register with our referral link and receive €20 in Hetzner Cloud credits.Read how to create an API token in Hetzner Cloud.Connect your cloud by adding a Hetzner Cloud API token:
neterial provider init hcloud

​
SSH keys

Add your SSH public key to enable git push deployments. The --auto-detect flag tries to discover your SSH key automatically: 
neterial ssh-key add --auto-detect
Or specify a key file: 
neterial ssh-key add ~/.ssh/id_ed25519.pub
List your SSH keys: 
neterial ssh-key list
Delete an SSH key: 
neterial ssh-key delete <key-id>

​
VMs

​
Create VM

Create with default settings: 
neterial infra create vm
Set name and cloud provider (hcloud or aws): 
neterial infra create vm --name [VM_NAME] --cloud [CLOUD]
Set location: 
neterial infra create vm --cloud hcloud --location ash
neterial infra create vm --cloud aws --location us-east-1

​
List VMs

neterial infra get vms

​
Delete VM

neterial infra delete vm --name [VM_NAME]

​
VM types

You can choose the VM type when creating to control compute capacity: 
neterial infra create vm --name [VM_NAME] --vm-type [VM_TYPE]

​
Accessing your VM

​
Get kubeconfig

Get kubeconfig for the default VM: 
neterial infra get kubeconfig
Get kubeconfig for a specific VM: 
neterial infra get kubeconfig --cluster [VM_NAME]
Then access your cluster: 
kubectl get nodes

​
List nodes

View the Kubernetes nodes in your cluster: 
neterial infra get nodes --cluster [VM_NAME]

​
Deploying apps

Deploy your apps using git push. First, add your VM as a git remote: 
git remote add neterial git@git.[WORKLOAD_HOSTNAME]:[APP_NAME].git
Then push to deploy: 
git push neterial main
Your app will be available at https://[APP_NAME].[WORKLOAD_HOSTNAME]. Use neterial infra get workload-hostname to get your VM’s hostname.

​
Container registry

Each VM includes a pre-installed container registry for storing your Docker images. Get container registry credentials: 
neterial infra get registry
Get registry for a specific VM: 
neterial infra get registry --name [VM_NAME]
Get credentials and automatically run docker login: 
neterial infra get registry --docker-login
Get only the registry hostname: 
neterial infra get registry --hostname

​
Workload hostname

Each VM has a unique hostname. Your deployed apps are available at subdomains of this hostname, e.g., https://myapp.[WORKLOAD_HOSTNAME]. Get the workload hostname: 
neterial infra get workload-hostname --cluster [VM_NAME]

​
Account

​
Delete account

Warning: This operation will permanently remove your Neterial account. You will still have access to your VMs, but you will no longer be able to manage them using the Neterial platform.
neterial account delete