> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nometria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Frequently asked questions about Nometria — deployment, security, pricing, support, and more.

## General

<AccordionGroup>
  <Accordion title="What is Nometria?">
    Nometria is a deployment and hosting platform purpose-built for apps created with AI/vibe-coding tools like Base44, Lovable, Bolt, Manus, and Emergent. We take your app from a prototype inside a builder to a production-grade deployment on AWS — with SSL, custom domains, backups, and monitoring included.
  </Accordion>

  <Accordion title="Which platforms does Nometria support?">
    We fully support **Base44**, **Lovable**, **Manus**, **Bolt**, and **Emergent**. You can also deploy any React, Vite, Next.js, or Node.js project via ZIP upload or GitHub — select **Custom / Other** during onboarding. Static HTML sites (no package.json) are supported too.
  </Accordion>

  <Accordion title="Do I need an AWS account?">
    No. Nometria provisions and manages AWS infrastructure on your behalf. You don't need to create an AWS account, configure IAM, or touch the AWS console. If you prefer to deploy into your own AWS account, we support that on the Growth plan and above via cross-account IAM roles.
  </Accordion>

  <Accordion title="Can I deploy apps not built with a vibe-coding tool?">
    Yes. Any React, Vite, Next.js, or Node.js app can be deployed via ZIP upload or GitHub. Select **Custom / Other** as your platform during onboarding. Static HTML/JS sites without a package.json are also supported.
  </Accordion>

  <Accordion title="What regions can I deploy to?">
    We currently support `us-east-1` (N. Virginia), `eu-west-1` (Ireland), `ap-south-1` (Mumbai), and `af-south-1` (Cape Town). More regions are coming soon. Enterprise customers can request additional regions.
  </Accordion>
</AccordionGroup>

## Deployment

<AccordionGroup>
  <Accordion title="How does deployment work?">
    When you click **Deploy**, Nometria:

    1. Packages your code (from GitHub or a ZIP upload)
    2. Provisions an EC2 instance in your chosen region
    3. Installs dependencies and builds your app
    4. Configures nginx with SSL (via Let's Encrypt)
    5. Sets up DNS records for your subdomain or custom domain
    6. Starts your app with PM2 for process management

    The entire process typically takes 3–8 minutes.
  </Accordion>

  <Accordion title="What tech stacks are supported?">
    * **Frontend:** React, Vite, Next.js, static HTML/JS
    * **Backend:** Node.js, Deno, Express, Next.js API routes
    * **Database:** Supabase (self-hosted or cloud), Appwrite, PostgreSQL (via Drizzle/Prisma)
    * **Package managers:** npm, pnpm (auto-detected from lockfile)

    We auto-detect your stack from your project structure — no manual configuration needed in most cases.
  </Accordion>

  <Accordion title="How do I connect my code?">
    Three ways:

    * **GitHub** — Authorize Nometria to read your repository. Best for ongoing development with two-way sync.
    * **ZIP upload** — Export your project as a ZIP from your builder and upload it.
    * **Chrome Extension** — Install the Nometria extension to export directly from your builder with one click.
  </Accordion>

  <Accordion title="What happens if my deployment fails?">
    Nometria sends a Slack alert to our team and marks the deployment as failed in your dashboard. Common causes include missing environment variables, build errors, or dependency conflicts. You can view deployment logs in **App Details → Logs** and re-trigger a deployment after fixing the issue. Our support team proactively monitors failures and will reach out if needed.
  </Accordion>

  <Accordion title="Can I deploy a static HTML site without package.json?">
    Yes. If your project contains an `index.html` but no `package.json`, Nometria detects it as a static site and serves it directly via nginx — no build step required. This works for exported landing pages, vanilla JS apps, and static prototypes.
  </Accordion>

  <Accordion title="Does Nometria support monorepos?">
    Yes. Nometria auto-detects monorepo structures (pnpm workspaces, apps/ directories). It installs at the workspace root first, then builds the appropriate app directory. If multiple apps exist, it selects the one with a Vite config or package.json.
  </Accordion>

  <Accordion title="Can I roll back to a previous deployment?">
    Yes. You can roll back to any previous deployment version from the CLI using `nom rollback` or from your dashboard. Rollbacks are instant — no rebuild required.
  </Accordion>
</AccordionGroup>

## Security & Compliance

<AccordionGroup>
  <Accordion title="Is my data secure?">
    Yes. Your code and data are handled with enterprise-grade security:

    * **Encryption in transit:** All traffic is encrypted via TLS 1.2+ (HTTPS enforced by default)
    * **Encryption at rest:** EBS volumes and S3 storage use AES-256 encryption
    * **Network isolation:** Each app runs on a dedicated EC2 instance with its own security group
    * **No shared databases:** Your Supabase/Appwrite instance is fully isolated
    * **Access control:** API keys are never stored in plaintext; secrets are injected via environment variables
  </Accordion>

  <Accordion title="Does Nometria access or store my source code?">
    Your code is uploaded to a private S3 bucket for deployment and transferred to your EC2 instance. We do not read, analyze, or share your source code. The S3 artifacts are retained only for redeployment and rollback purposes. You can request deletion at any time.
  </Accordion>

  <Accordion title="Is Nometria SOC 2 compliant?">
    We are actively working toward SOC 2 Type II certification. Growth plan customers receive dedicated support for compliance requirements. Enterprise customers can request our current security posture documentation, penetration test results, and compliance roadmap.
  </Accordion>

  <Accordion title="What cloud provider do you use?">
    All deployments run on **Amazon Web Services (AWS)** by default — specifically EC2 instances with Graviton (ARM64) processors for optimal price-performance. Enterprise customers can also deploy to GCP, Azure, DigitalOcean, or Hetzner.
  </Accordion>

  <Accordion title="Can I deploy to my own AWS account?">
    Yes. On the Growth plan and above, you can connect your own AWS account via cross-account IAM roles. Nometria deploys and manages the infrastructure, but the resources live in your account for full audit trail and compliance.
  </Accordion>

  <Accordion title="How are environment variables and secrets handled?">
    Secrets are stored securely and injected as environment variables at deploy time. They are written to `.env` on the instance and never logged or exposed in the dashboard UI. You can manage them via the CLI (`nom env set`) or the dashboard.
  </Accordion>

  <Accordion title="Do you have DDoS protection?">
    All deployments sit behind AWS infrastructure which includes basic DDoS mitigation. For advanced protection, Enterprise customers can enable AWS Shield Advanced and WAF. We recommend using Cloudflare as a CDN/proxy for additional edge protection.
  </Accordion>
</AccordionGroup>

## Pricing & Billing

<AccordionGroup>
  <Accordion title="How much does Nometria cost?">
    | Plan         | Price          | What you get                                                       |
    | ------------ | -------------- | ------------------------------------------------------------------ |
    | **Hobby**    | Free           | Shared server, 2 GB RAM, daily backups, community support          |
    | **Starter**  | \$25/mo        | Dedicated server, 4 GB RAM, custom domain + SSL, 24h email support |
    | **Growth**   | \$99/mo        | 8 GB RAM, priority support, SOC 2 support, monitoring & RCA        |
    | **Download** | \$499 one-time | Full source code, deploy anywhere, no monthly fees                 |

    Enterprise and custom configurations are available — [book a call](https://calendly.com/intro-nometria/30min).
  </Accordion>

  <Accordion title="Is there a free tier?">
    Yes. The **Hobby** plan is completely free — no credit card required. It includes a shared server with 2 GB RAM, daily backups, and community support. It's ideal for prototypes, demos, and personal projects. You can upgrade to a paid plan at any time.
  </Accordion>

  <Accordion title="What payment methods do you accept?">
    We accept all major credit and debit cards via Stripe. Enterprise customers can pay via invoice and bank transfer (ACH/wire).
  </Accordion>

  <Accordion title="Can I cancel anytime?">
    Yes. All paid plans are month-to-month with no long-term contracts. Cancel from your dashboard at any time — your app stays running until the end of the billing period. You can download your code before canceling.
  </Accordion>

  <Accordion title="Why is Nometria cheaper than deploying myself?">
    We leverage ARM-based Graviton instances, shared infrastructure for Hobby plans, and automated provisioning to keep costs low. A comparable self-managed AWS setup (EC2 + RDS + Route53 + ACM + monitoring) typically costs \$80–200/mo plus significant DevOps time. Nometria bundles all of this into a simple monthly price.
  </Accordion>

  <Accordion title="Do I get charged if my app is stopped?">
    No. If you stop your instance, billing pauses. You only pay for the time your app is running. Stopped instances retain their data and can be restarted at any time.
  </Accordion>

  <Accordion title="Can I upgrade or downgrade my plan?">
    Yes. You can upgrade or downgrade your instance size at any time from the dashboard or CLI. Upgrades take effect immediately (with prorated billing). Downgrades take effect at the next billing cycle.
  </Accordion>
</AccordionGroup>

## Custom Domains & SSL

<AccordionGroup>
  <Accordion title="How do I add a custom domain?">
    1. Go to **App Details → Custom Domain** in your dashboard
    2. Enter your domain (e.g., `myapp.com`)
    3. Add the DNS records shown to your domain registrar (A record or CNAME)
    4. Nometria automatically provisions an SSL certificate

    You can also use the CLI: `nom domain add myapp.com`
  </Accordion>

  <Accordion title="Is SSL included?">
    Yes. Free SSL certificates are automatically provisioned for all apps — both `*.ownmy.app` subdomains and custom domains. HTTPS is enforced by default.
  </Accordion>

  <Accordion title="How long does DNS propagation take?">
    DNS changes typically propagate within 5–30 minutes, though it can take up to 48 hours depending on your registrar and TTL settings. Nometria sets a 300-second (5 min) TTL by default.
  </Accordion>

  <Accordion title="Can I use a subdomain instead of a root domain?">
    Yes. You can point any subdomain (e.g., `app.mycompany.com`) to your Nometria deployment. Just add a CNAME record pointing to your `*.ownmy.app` address.
  </Accordion>
</AccordionGroup>

## Databases

<AccordionGroup>
  <Accordion title="Which databases are supported?">
    * **Supabase (self-hosted):** Nometria deploys a full Supabase stack (PostgreSQL, GoTrue auth, PostgREST, Realtime) on your instance. Included at no extra cost.
    * **Supabase (cloud):** Connect your own Supabase Cloud project. Your app uses the remote database while running on Nometria infrastructure.
    * **Appwrite (self-hosted):** Full Appwrite stack deployed alongside your app.
    * **Drizzle/Prisma:** Auto-detected and migrations run automatically during deployment.
  </Accordion>

  <Accordion title="Are database migrations run automatically?">
    Yes. Nometria auto-detects your migration tooling:

    * `run-migrations.sh` — executed if present in your project
    * Drizzle (`drizzle.config.*`) — `db:push` or `db:migrate` is attempted
    * Prisma (`prisma/schema.prisma`) — `prisma migrate deploy` or `prisma db push` is attempted
    * Lovable (`scripts/start.sh`) — `supabase db push` is attempted

    Migration output is logged to `/home/ubuntu/migrations.log` on the instance.
  </Accordion>

  <Accordion title="Can I connect an external database?">
    Yes. Set your `DATABASE_URL` or `SUPABASE_URL` environment variable to point to any external PostgreSQL, Supabase, or compatible database. Nometria will not provision a local database in that case.
  </Accordion>
</AccordionGroup>

## CLI & Developer Tools

<AccordionGroup>
  <Accordion title="What is the nom CLI?">
    `nom` is Nometria's command-line tool for deploying, managing, and monitoring your apps. Install it with:

    ```bash theme={null}
    npm install -g nometria
    ```

    Then authenticate with `nom login` and deploy with `nom deploy`.
  </Accordion>

  <Accordion title="Does Nometria integrate with AI coding tools?">
    Yes. Nometria has native integrations with:

    * **Claude Code** — MCP server plugin for deploy, preview, and status commands
    * **Cursor** — Rules file auto-generated for deployment context
    * **Windsurf / Continue.dev** — Config files auto-generated
    * **GitHub Copilot** — Instructions file for deployment context

    Run `nom setup` to generate all integration files.
  </Accordion>

  <Accordion title="Can I use GitHub Actions for CI/CD?">
    Yes. Connect your GitHub repo and Nometria will auto-deploy on every push to your configured branch. You can also use `nom deploy` in your own GitHub Actions workflow.
  </Accordion>

  <Accordion title="Is there a preview/staging environment?">
    Yes. Run `nom preview` to create a temporary staging preview of your app. Previews are free, expire in 2 hours, and are accessible via a unique URL. Great for testing before deploying to production.
  </Accordion>
</AccordionGroup>

## GitHub Sync

<AccordionGroup>
  <Accordion title="How does two-way GitHub sync work?">
    When you connect GitHub, Nometria creates a `builder/latest` branch for changes coming from your vibe-coding tool. You develop on `main` as usual. Nometria handles merging and conflict resolution between the two branches. Push to `main` to trigger a production deployment.
  </Accordion>

  <Accordion title="What happens if there's a merge conflict?">
    Nometria detects conflicts and notifies you via the dashboard. You can resolve conflicts in your IDE or GitHub and push the resolution. Nometria will then continue the sync automatically.
  </Accordion>
</AccordionGroup>

## Support & SLA

<AccordionGroup>
  <Accordion title="What support is included?">
    | Plan           | Support level                               |
    | -------------- | ------------------------------------------- |
    | **Hobby**      | Community support (GitHub, docs)            |
    | **Starter**    | 24h email support                           |
    | **Growth**     | Priority support with monitoring & RCA      |
    | **Enterprise** | Dedicated Slack channel, phone support, SLA |
  </Accordion>

  <Accordion title="What is the uptime SLA?">
    We target 99.9% uptime for all paid plans. Enterprise customers receive a contractual SLA with financial credits for downtime. We monitor all deployments 24/7 and proactively alert on issues.
  </Accordion>

  <Accordion title="How do I get help?">
    * **Docs:** [docs.nometria.com](https://docs.nometria.com)
    * **Email:** [hello@nometria.com](mailto:hello@nometria.com)
    * **Book a call:** [calendly.com/intro-nometria/30min](https://calendly.com/intro-nometria/30min)
    * **Dashboard chat:** Available on all pages
  </Accordion>
</AccordionGroup>

## Backups & Monitoring

<AccordionGroup>
  <Accordion title="Are backups included?">
    Yes. Daily automated backups are included on all plans. Backups include your application code, database, and environment configuration. You can also trigger manual backups via the CLI with `nom backup`.
  </Accordion>

  <Accordion title="Can I restore from a backup?">
    Yes. Contact support or use the CLI to restore from any daily backup. Enterprise customers can configure custom backup schedules and retention policies.
  </Accordion>

  <Accordion title="What monitoring is included?">
    All paid plans include:

    * Instance health checks
    * Deployment status tracking
    * Resource usage monitoring (CPU, memory, disk)

    Growth and Enterprise plans add:

    * Proactive alerting
    * Root cause analysis (RCA) for incidents
    * Custom monitoring dashboards
  </Accordion>
</AccordionGroup>

## Migration & Portability

<AccordionGroup>
  <Accordion title="Can I migrate away from Nometria?">
    Absolutely. You own your code and data. You can:

    * Download your full source code at any time
    * Export your database via standard PostgreSQL tools
    * SSH into your instance (available on Growth+ plans)

    There is zero vendor lock-in. Your app runs on standard AWS EC2 instances with no proprietary runtime.
  </Accordion>

  <Accordion title="How do I migrate from another hosting provider?">
    If you're moving from Vercel, Railway, Render, or another host:

    1. Push your code to GitHub (or export as ZIP)
    2. Create a new migration in Nometria
    3. Select **Custom / Other** as your platform
    4. Connect via GitHub or upload your ZIP
    5. Deploy

    Nometria handles the rest — DNS, SSL, database setup, and process management.
  </Accordion>

  <Accordion title="Does Nometria handle data migration?">
    For Base44 apps, we automatically migrate your data (tables, users, storage) to the self-hosted Supabase instance. For other platforms, data migration depends on your database type. Contact support for assisted migration.
  </Accordion>
</AccordionGroup>

## Enterprise

<AccordionGroup>
  <Accordion title="What's included in the Enterprise plan?">
    * Multi-cloud deployment (AWS, GCP, Azure, DigitalOcean, Hetzner)
    * Deploy to your own cloud account
    * Custom instance sizes (16 GB+ RAM)
    * Dedicated Slack channel and phone support
    * Contractual SLA with financial credits
    * SOC 2 compliance support
    * Custom backup schedules and retention
    * Priority feature requests
    * Volume discounts for multiple apps
  </Accordion>

  <Accordion title="Can I deploy to multiple cloud providers?">
    Yes. Enterprise customers can deploy to AWS, GCP, Azure, DigitalOcean, or Hetzner. Each app can be deployed to a different provider and region based on your requirements.
  </Accordion>

  <Accordion title="Do you offer a startup program?">
    Yes. Early-stage startups can apply for our Startup Program which includes extended free hosting, priority support, and migration assistance. [Apply here](https://nometria.com/startup-program).
  </Accordion>

  <Accordion title="How do I contact sales?">
    [Book a 30-minute call](https://calendly.com/intro-nometria/30min) or email us at [hello@nometria.com](mailto:hello@nometria.com). We typically respond within 4 hours on business days.
  </Accordion>
</AccordionGroup>