💡 Si tu aplicación ya usa MongoDB, puedes apuntar el mismo driver/connection string a FerretDB sin cambiar código.

Requisitos de VM

Recurso	Minimo
CPU	2 vCPU
RAM	4 GB
Disco	40 GB
Sistema Operativo	Ubuntu 22.04 / 24.04

Puerto de acceso

Puerto	Protocolo	Uso
30017	TCP	Protocolo MongoDB wire (compatible con todos los drivers MongoDB)

Cómo acceder

FerretDB acepta cualquier cliente o driver compatible con MongoDB.

‍

Con mongosh

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

‍

Connection string para aplicaciones

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

‍

Ejemplo con Node.js (mongoose)

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

‍

ℹ️ Si no configuraste contraseña al desplegar, búscala en los outputs del deployment en el portal de Cuemby. El usuario por defecto es ferretdb.

Validar que FerretDB Está Activo

# Ver el pod de FerretDB
kubectl get pods -A | grep ferretdb

# Ver log de instalación
tail -f /var/log/cuemby/bootstrap.log

# Verificar que el puerto está escuchando
ss -tlnp | grep 30017

‍

Output esperado:

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

Parámetros de configuración

Parámetro	Default	Descripción
FERRETDB_DB_PASSWORD ⚠️	auto-generado	Contraseña del usuario de base de datos. Si se deja vacío, Cuemby genera una aleatoria.
FERRETDB_DB_DATA_SIZE	20Gi	Tamaño del volumen persistente para PostgreSQL (backend de FerretDB).

Primeros pasos (inicio rápido)

// Crear una colección e insertar un documento
use mi_app
db.usuarios.insertOne({ nombre: "Martin", activo: true })

// Consultar documentos
db.usuarios.find({ activo: true })

// Listar colecciones
show collections

Solución rápida de problemas

Problema	Causa probable	Solución
Connection refused	FerretDB aún iniciando	Espera ~3–5 min y revisa tail -f /var/log/cuemby/bootstrap.log.
Authentication failed	Credenciales incorrectas	Revisa los outputs del deployment en el portal de Cuemby.
Comandos no soportados	Limitación de FerretDB vs MongoDB	Consulta la lista de compatibilidad.
Pod en CrashLoopBackOff	Disco o RAM insuficiente	Verifica con kubectl describe pod -n .

Cuemby Cloud

IaaS

Acerca de Cuemby Cloud

Cuemby Cloud es una infraestructura de nube de nivel empresarial gestionada desde una única consola, diseñada para ofrecer una seguridad más sólida, operaciones predecibles y una fácil escalabilidad en todas las regiones.

Regiones de centros de datos disponibles en Colombia, Ecuador y Chile

Respaldado por ubicaciones de centros de datos de nivel III y nivel IV

Tarifas de entrada y salida de red cero

Soporte de expertos locales 24/7

Comienza Gratis

Descubre Cuemby Cloud

FerretDB