Nhost is an open-source Firebase alternative with GraphQL.
The Nhost CLI is used to set up a local development environment. This environment will automatically track database migrations and Hasura metadata.
It's recommended to use the Nhost CLI and the Nhost GitHub Integration to develop locally and automatically deploy changes to production with a git-based workflow (similar to Netlify & Vercel).
- Nhost Dashboard
- Postgres Database
- GraphQL Engine
- Auth
- Storage
- Nhost Serverless Functions
- Minio S3
- Mailhog
brew install nhost/tap/nhostIf you have flakes enabled:
nix profile install github:nhost/nhost#cliOr run it directly without installing:
nix run github:nhost/nhost#cliInstall the CLI in a project to pin the version for the whole team:
npm install -D @nhost/cli
pnpm add -D @nhost/cli
yarn add -D @nhost/cli
bun add -d @nhost/cliOr run it without installing:
npx @nhost/cli@latest --version
pnpm dlx @nhost/cli@latest --version
yarn dlx @nhost/cli@latest --version
bunx @nhost/cli@latest --versioncurl -sSL https://raw.githubusercontent.com/nhost/nhost/main/cli/get.sh | bashOr specify a version:
curl -sSL https://raw.githubusercontent.com/nhost/nhost/main/cli/get.sh | bash -s 1.38.0The steps below are a quick reference. For a guided walkthrough, see the CLI Quickstart.
Only needed to pull configuration from an existing Nhost Cloud project or to deploy — skip it for purely local work.
nhost loginScaffolds a nhost/ directory (backend configuration, version-controlled in Git) and a functions/ directory.
nhost initOr start from an existing Nhost Cloud project:
nhost init --remoteSpins up the full stack (Postgres, GraphQL, Auth, Storage, Functions) with Docker and prints the local service URLs.
nhost upThe local dashboard runs at https://local.dashboard.local.nhost.run. Stop the stack with nhost down and follow logs with nhost logs.
The Nhost cli ships with an MCP server that lets you interact with your Nhost projects through AI assistants using the Model Context Protocol. It provides secure, controlled access to your GraphQL data, project configuration, and documentation—with granular permissions that let you specify exactly which queries and mutations an LLM can execute. For development, it streamlines your workflow by enabling AI-assisted schema management, metadata changes, and migrations, while providing direct access to your GraphQL schema for intelligent query building.
You can read more about the MCP server in the MCP Server documentation.
Make sure you have Go 1.18 or later installed.
The source code includes a self-signed certificate for testing purposes. Nhost workers with configured access to AWS may use the cert.sh script to generate a real certificate from Let's Encrypt.
go build -o /usr/local/bin/nhostThis will build the binary available as the nhost command in the terminal.
- macOS
- Linux
- Windows WSL2