Documentation

Getting Started

Create your first project, deploy a service from Git, and publish a production URL. This guide mirrors the flow in the nouva dashboard.

Quickstart

  1. Create a new project in the dashboard.
  2. Add an app or worker service and connect your GitHub repo.
  3. nouva detects your stack and builds automatically.
  4. Review the deployment logs and watch the service go live.
  5. Add a database service or volume if your app needs storage.
  6. Use the provided app URL or attach a custom domain that points to your server.

Deploy your first app

From the dashboard, create a project and click "New Service". Choose App, link a GitHub repository, and select a branch. nouva builds and deploys on every push to the selected branch.

  • Auto-detects Node.js, Python, Go, or Dockerfile workflows.
  • Creates a deployment with build output and runtime logs.
  • Publishes a service URL once health checks pass.

Add a database or volume

Need persistence? Create a PostgreSQL or Redis service, or attach a volume for custom storage. Credentials are injected automatically as environment variables.

Explore details in Databases and Volumes.

Go live

Once your service is healthy, you can share the generated *.up.nouva.cloud URL immediately or attach a custom domain from the Domains tab. Custom-domain DNS points to your server and Traefik on that server handles HTTPS.

Need help? Review Domains and Deployments.