Skip to main content

​
Install the CLI

The CLI requires Node.js 18 or newer. Check your version with node --version.

​
Verify the installation

nom --version
You should see the version number printed (e.g. 0.1.0).

​
Sign in

You need to authenticate before you can deploy. There are three ways to do this.

​
Option 1: Browser sign-in (easiest)

nom login
This opens your browser where you can sign in with Google, GitHub, or email. Once you sign in, the browser redirects back to the CLI automatically. No tokens to copy.
The browser method creates a persistent API key and saves it to ~/.nometria/credentials.json so you stay signed in across terminal sessions.

​
Option 2: API key paste

If you are on a remote server or the browser method does not work:
1

Get an API key

Go to nometria.com/settings/api-keys and generate a new key.
2

Run login with the --api-key flag

nom login --api-key
Paste your key when prompted. The CLI verifies it and saves it.

​
Option 3: Environment variable

Set the NOMETRIA_API_KEY environment variable and the CLI will use it automatically. This is the best option for CI/CD pipelines: 
export NOMETRIA_API_KEY=nometria_sk_your_key_here
Keep your API key private. Never commit it to version control. Use your CI provider’s secrets feature for automated deployments.

​
Environment variables

VariableDescription
NOMETRIA_API_KEYYour API key. Overrides saved credentials from nom login.
NOMETRIA_API_URLCustom API endpoint. You almost never need to change this.
NOM_DEBUGSet to any value to enable debug output for troubleshooting.

​
Verify you are signed in

nom whoami
This prints your email address and confirms the CLI is ready to use.

​
What’s next

Initialize a project

Run nom init to detect your framework and create a config file.

Deploy

Run nom deploy to push your app to production.