Installing Mongonaut

Mongonaut is available as a Docker image, making it easy to run alongside your MongoDB instance.

Note: Mongonaut is available on both GitHub Container Registry (ghcr) and Docker Hub. Due to Docker Hub's rate limiting changes starting April 1, 2025, we recommend using ghcr.io.

The examples below use ghcr.io, but you can also use Docker Hub by replacing ghcr.io/usemongonaut/mongonaut with mongonaut/mongonaut.

Quick Start

docker run -it --rm \
    -p 8081:8081 \
    -e MONGO_CONNECTION_URL="mongodb://mongo:27017/" \
    ghcr.io/usemongonaut/mongonaut

Security Warning: The examples above expose Mongonaut publicly on port 8081 without authentication. It is your responsibility to properly secure access to Mongonaut in production environments. Consider using:

Cloudflare Zero Trust Tunnel (recommended)
A reverse proxy with authentication
Network-level security controls

Never expose an unsecured Mongonaut instance directly to the internet, as this could allow unauthorized access to your MongoDB databases!

Full Docker Compose example

services:
  mongonaut:
    image: ghcr.io/usemongonaut/mongonaut
    ports:
      - 8081:8081
    environment:
      MONGO_CONNECTION_URL: mongodb://mongo:27017/
    networks:
      - mongo-network
 
  mongo:
    image: mongo:latest
    ports:
      - 27017:27017
    networks:
      - mongo-network
 
networks:
  mongo-network:
    driver: bridge

Environment Variables

Variables	Description	Default
`MONGO_CONNECTION_URL`	URL of the target MongoDB	`mongodb://mongo:27017/`
`MONGONAUT_READONLY`	Whether the data is editable or not	`false`

Installing Mongonaut

Quick Start

Full Docker Compose example

Environment Variables

On this page