Skip to main content

​
Quick reference

CommandWhat it does
nom initCreate a nometria.json config file
nom deployDeploy to production
nom previewDeploy a staging preview (free, 2 hours)
nom statusCheck deployment status
nom logsView deployment logs
nom loginSign in via browser or API key
nom whoamiShow your current account
nom githubConnect GitHub for auto-deploy
nom startStart a stopped instance
nom stopStop a running instance
nom terminatePermanently delete an instance
nom upgradeResize your instance
nom domainAdd a custom domain
nom envManage environment variables
nom scanRun an AI security scan
nom setupGenerate AI tool config files

​
Global options

These options work with every command:
OptionShortDescription
--help-hShow help
--version-vShow CLI version
--yes-ySkip confirmation prompts
--jsonOutput as JSON (for scripting)

​
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.
nom init
What it creates:
{
  "name": "my-app",
  "framework": "vite",
  "platform": "aws",
  "region": "us-east-1",
  "instanceType": "4gb",
  "build": {
    "command": "npm run build",
    "output": "dist"
  },
  "env": {},
  "ignore": []
}
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.
nom deploy
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:
  Deploying my-app to aws (us-east-1)...

  Building... done (4.2s)
  Uploading... done (1.8s)
  Deploying... started

  URL: https://my-app.nometria.com
  Status: deploying

  Run `nom status` to check progress.
Deploy a temporary staging version of your app. Previews are free and expire after 2 hours.
nom preview
Example output:
  Preview ready!
  URL: https://preview-a1b2c3.nometria.com
  Expires: 2 hours
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.
nom status
Example output:
  App: my-app
  Status: running
  URL: https://my-app.nometria.com
  Instance: 4gb
  IP: 54.123.45.67
Use --json to get machine-readable output for scripts:
nom status --json
View deployment and runtime logs.
nom 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.
nom login
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.
nom whoami
Example output:
  Authenticated as you@example.com
Manage GitHub integration for automatic deployments. This command has four subcommands.
nom github connect
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.
nom start
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.
nom stop
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.
nom terminate
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.
nom upgrade 8gb
Example output:
  Upgraded to 8gb.
The upgrade happens with minimal downtime — your app restarts on the new instance size.
Add a custom domain to your app.
nom domain add myapp.example.com
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.
nom env set DATABASE_URL=postgres://...
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.
nom scan
Example output:
  Security: 92/100
  Performance: 87/100
  Code Quality: 95/100

  Issues:
  - [medium] Missing CSP header: Add a Content-Security-Policy header
  - [low] Unoptimized images: 3 images could be compressed further
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.
nom setup
Example output:
  Setting up AI tool integrations for Nometria

    .cursor/rules/nometria.mdc
    .clinerules
    .windsurfrules
    .github/copilot-instructions.md
    .github/workflows/nometria-deploy.yml
    CLAUDE.md
    AGENTS.md
    .claude/commands/deploy.md
    .claude/commands/preview.md
    .claude/commands/status.md
    .claude/commands/nometria-login.md
    .continue/config.json

  All AI tools now know how to deploy this project with Nometria.

  Claude Code users can now type:
    /deploy            Deploy to production
    /preview           Staging preview (free, 2hr)
    /status            Check deployment status
    /nometria-login    Set up authentication
See the AI tools setup guide for details on each file, and the slash commands guide for Claude Code commands.