Computers

Create a computer

Create a computer and confirm it is ready to run commands

You need the CLI installed and signed in and a selected workspace with the admin or editor role. The examples name the computer demo, which must be free in the workspace.

Create

Create a computer with the platform defaults:

nevia new demo

During the beta, computers run curated images. --image picks one. Without it, nevia new uses the platform default.

The platform does not run an image's startup command. Start workloads with nevia exec. See nevia new for all options.

-e KEY=value sets an env var. -e secrets.NAME and -e variables.NAME pull values from the workspace. See Give computers secrets and variables and Computer environment variables.

Check the result

Inspect the computer with nevia status:

nevia status demo

The output shows state ready when creation finishes. If creation is still running, repeat the command or track the operation. If creation failed, the output includes an error.

When ready, url shows the computer's address. To serve a program, declare a port with -p 443:8080 on nevia new, or later with nevia set demo -p 443:8080. Then start a program that listens on that port. See Publish a computer on an HTTPS URL and Computer ports and URLs.

Commands start in your home directory. That directory lives on the persistent disk, which exists when the deployment has a storage pool. Keep files there to survive a branch or checkpoint. See Computer lifecycle states.

Next, run a command.

On this page