💡 If your application already uses MongoDB, you can point the same driver/connection string to FerretDB without changing code.

VM Requisites

Resource	Minimum
CPU	2 vCPU
RAM	4 GB
Disk	40 GB
Operating System	Ubuntu 22.04 / 24.04

Access Port

Port	Protocol	Usage
30017	TCP	MongoDB wire protocol (compatible with all MongoDB drivers)

How To Access

FerretDB accepts any client or driver compatible with MongoDB.

‍

With mongosh

mongosh "mongodb://<USUARIO>:<PASSWORD>@<IP_DE_LA_VM>:30017/"

‍

Connection string for applications

mongodb://<USUARIO>:<PASSWORD>@<IP_DE_LA_VM>:30017/<database>

‍

Example with Node.js (mongoose)

mongoose.connect("mongodb://ferretdb:<PASSWORD>@200.25.101.125:30017/mi_app");

‍

ℹ️ If you didn't set a password during deployment, look for it in the deployment outputs in the Cuemby portal. The default username is ferretdb.

Verify that FerretDB is active

# See the FerretDB pod
kubectl get pods -A | grep ferretdb

# View installation log
tail -f /var/log/cuemby/bootstrap.log

# Verify that the port is listening
ss -tlnp | grep 30017

‍

Expected output:

NAME                        READY   STATUS    RESTARTS
ferretdb-xxxxxxxxx-xxxxx    1/1     Running   0        ← Running ✓

Configuration Parameters

Parameter	Default	Description
FERRETDB_DB_PASSWORD ⚠️	auto-generated	Database user password. If left blank, Cuemby generates a random one.
FERRETDB_DB_DATA_SIZE	20Gi	Persistent volume size for PostgreSQL (FerretDB backend).

First Steps (quick start)

// Create a collection and insert a document
use mi_app
db.usuarios.insertOne({ nombre: "Martin", activo: true })

// View documents
db.usuarios.find({ activo: true })

// List collections
show collections

Quick Troubleshooting

Problem	Probable cause	Solution
Connection refused	FerretDB still starting	Wait ~3–5 min and check tail -f /var/log/cuemby/bootstrap.log.
Authentication failed	Incorrect credentials	Review the deployment outputs in the Cuemby portal.
Unsupported commands	Limitations of FerretDB vs MongoDB	Check the compatibility list.
Pod in CrashLoopBackOff	Insufficient disk space or RAM	Check with kubectl describe pod -n .

Cuemby Cloud

IaaS

About Cuemby Cloud

Cuemby Cloud is enterprise-grade cloud infrastructure managed from a single console, built for stronger security, predictable operations, and easy scaling across regions.

Datacenters regions available in Colombia, Ecuador, and Chile

Backed by Tier III / Tier IV data center locations

Zero Network Ingress and Egress Fees

24/7 local expert support

Get Started for Free

Discover Cuemby Cloud

FerretDB