Skip to main content

​
Quick reference

​
Global options

These options work with every command:

​
Detailed command reference

Create a nometria.json config file in the current directory. The CLI auto-detects your framework (Next.js, Vite, Remix, or static) and sets sensible defaults.
What it creates:
The CLI detects your framework by looking for config files like next.config.js, vite.config.ts, or remix.config.js. If nothing is found, it defaults to static.
Build and deploy your project to production. This is the default command — running nom with no arguments does the same thing.
What happens:
  1. Reads nometria.json for your config
  2. Runs your build command (e.g. npm run build)
  3. Packages your code (excluding node_modules, .git, .env)
  4. Uploads and deploys to your chosen cloud
  5. Returns a live URL
Example output:
Deploy a temporary staging version of your app. Previews are free and expire after 2 hours.
Example output:
Previews are perfect for sharing a quick link with a teammate or testing a change before going to production.
Check the current deployment status of your app.
Example output:
Use --json to get machine-readable output for scripts:
View deployment and runtime logs.
The -f (follow) flag keeps the connection open and streams new log lines as they happen, similar to tail -f.
Sign in to your Nometria account. See the installation guide for details on all login methods.
The browser method opens a sign-in page where you authenticate with Google, GitHub, or email. The CLI picks up the credentials automatically.
Show the email address of the currently signed-in user.
Example output:
Manage GitHub integration for automatic deployments. This command has four subcommands.
Opens your browser to authorize GitHub access via OAuth. Once connected, pushes to your repo can trigger automatic deploys.
Start an instance that was previously stopped.
The instance resumes from where it left off. Your data and configuration are preserved.
Stop a running instance. The instance is paused but not deleted — you can restart it later with nom start.
Stopping an instance reduces your costs when you are not actively using it.
Permanently delete an instance and all its data. This cannot be undone.
This is destructive. The CLI will ask for confirmation unless you pass --yes.
Resize your instance to a different size. Available sizes: 2gb, 4gb, 8gb, 16gb.
Example output:
The upgrade happens with minimal downtime — your app restarts on the new instance size.
Add a custom domain to your app.
After running this, you will need to add a DNS record (usually a CNAME) pointing to your Nometria instance. SSL is provisioned automatically.
If you do not have a domain yet, your app is available at your-app-name.nometria.com by default.
Manage environment variables for your deployed app.
Set one or more environment variables. The app redeploys automatically with the new values.
Run an AI-powered security and performance scan on your deployed app.
Example output:
Generate configuration files so that AI coding tools (Cursor, Claude Code, Copilot, Cline, Windsurf, Continue.dev) know how to deploy your project. Also creates Claude Code slash commands, an AGENTS.md guide, and a GitHub Actions workflow.
Example output:
See the AI tools setup guide for details on each file, and the slash commands guide for Claude Code commands.