Nometria Deploy

Authenticate with Nometria. Provide an API key (starts with nometria_sk_) or omit to get sign-in instructions. Must be called before any other tool if not already authenticated. Keys are available at https://nometria.com/settings/api-keys.

Deploy the current project to production. Builds locally, uploads the archive, and triggers cloud deployment. For testing changes first, use nometria_preview instead. Requires nometria.json (use nometria_init to create). Supports AWS, GCP, Azure, DigitalOcean, Hetzner, and Vercel.

Create a free temporary staging preview. Deploys to an isolated sandbox that expires in 2 hours. Use this to test before deploying to production with nometria_deploy. No billing - previews are always free.

Roll back to a previous deployment version. If no deployment_id is specified, rolls back to the immediately previous version. Use nometria_status to check current state after rollback.

Check deployment status, instance state, URL, and IP address for an app. Use this to verify a deploy completed successfully or to check if an instance is running.

View recent deployment and application logs. Use this to debug deploy failures, check runtime errors, or monitor app behavior.

List all deployed apps with their status, platform, and payment info. Use this to find app IDs or get an overview of all deployments.

Get comprehensive project context in a single call: app name, framework, platform, status, URL, instance type, services, env var keys, GitHub connection, and estimated cost. Use this first to understand the current state before taking any action.

Initialize a nometria.json config file. Auto-detects framework (Next.js, Vite, Remix, Astro, SvelteKit, Nuxt, Node.js, Python, Deno), build commands, and multi-service architecture. Run this before first deploy.

Generate AI tool config files so every IDE and agent knows how to deploy this project. Creates: .cursor/rules, .clinerules, .windsurfrules, CLAUDE.md, .github/copilot-instructions.md, GitHub Action workflow, and Continue.dev config.

Connect GitHub for auto-deploy on push. Requires browser - instructs the user to run `nom github connect` in their terminal for OAuth authorization.

Check if GitHub auto-deploy is connected for this app and which GitHub user is linked.

List GitHub repos connected to your Nometria account. Useful for verifying which repo is linked to an app.

Push local code changes to the connected GitHub repo. Triggers auto-deploy if GitHub integration is active.

Start a stopped instance. Use this after nometria_stop to resume the app. Instance retains all data and configuration.

Stop a running instance to save costs. The instance is paused - data is preserved. Use nometria_start to resume. Billing pauses while stopped.

PERMANENTLY delete an instance and all its data. This is irreversible - the app, database, and files are destroyed. Use nometria_stop instead if you want to pause temporarily.

Resize an instance. Available sizes: 2gb ($39/mo), 4gb ($49/mo), 8gb ($79/mo), 16gb ($129/mo). The instance restarts during upgrade. No data loss.

Add a custom domain to your app with automatic SSL/TLS certificate provisioning via Let's Encrypt. Point your domain's DNS to the instance IP first, then add it here.

Set environment variables on the deployed instance. Variables are injected into the app process and persisted across resyncs. Use for API keys, database URLs, feature flags.

List all environment variable keys set on the deployed instance. Returns key names only (not values) for security.

Run an AI-powered security and performance audit. Returns scores (0-100) for security, performance, and code quality, plus actionable issues with severity levels and fix suggestions.

Add a backend service (database, cache, or storage) to your deployed instance. Provisions a Docker container with auto-generated credentials and injects the connection string as an environment variable. Available: postgres, mysql, mongodb, redis, minio.

List all backend services running on the instance with their type, version, port, and connection string. Use this to check what databases and caches are available.

Remove a backend service from the instance. WARNING: This deletes the service container and its data. Create a backup first with nom db backup.

Execute a read-only SQL query against a PostgreSQL or MySQL database on the instance. Returns results as JSON. Queries are wrapped in a read-only transaction - DDL and writes are blocked. For schema changes, use nometria_db_create_table.

List all tables in the database with row counts and column info. Use this to understand the database schema before writing queries.

Describe a table's schema: columns, data types, constraints, indexes, and foreign keys. Use this before writing queries or creating related tables.

Create a new database table. Generates and executes CREATE TABLE SQL with the specified columns. Automatically adds id (UUID), created_at, and updated_at columns.

Add a webhook URL to receive notifications for deployment events. Supports: deploy.started, deploy.success, deploy.failed, preview.created, instance.started, instance.stopped, backup.completed.

List all configured webhooks for an app with their URLs and subscribed events.

Remove a webhook subscription.

Get documentation about Nometria features. Use this when you need to understand how a feature works before using it. Covers deployment, databases, services, auth, domains, and troubleshooting.