Migrar de undb a Teable en un VPS ServOrbit

El problema con undb en 2025–2026

Por qué migrar ahora y no en seis meses

• Riesgo de seguridad activo: las dependencias npm sin actualizar acumulan CVEs conocidos; una instancia de undb expuesta a Internet sin un reverse proxy reforzado es una superficie de ataque creciente.
• Bugs sin corregir en producción: las regresiones en la importación CSV y las fórmulas reportadas a finales de 2025 no tienen solución; si tu uso toca estas funcionalidades, la situación solo empeora.
• Dependencias congeladas: Node.js LTS avanza, las imágenes base de Docker cambian; un proyecto sin mantenimiento acaba fallando en la compilación, bloqueando las actualizaciones de seguridad del host.
• La comunidad se mueve: las discusiones en foros de self-hosting (Reddit r/selfhosted, awesome-selfhosted) muestran una tendencia clara hacia Teable, NocoDB y Grist; quedarse en undb significa perder acceso a integraciones activas y scripts de la comunidad.
• Datos huérfanos: cuanto más tiempo pasa, mayor es la probabilidad de un cambio interno de esquema no documentado; exportar ahora, cuando el formato de salida es conocido y estable, es más seguro que esperar una futura incompatibilidad.
• Ventana de migración limpia: tus datos están frescos y consistentes ahora; una migración forzada — porque la instancia no arranca tras una actualización de Docker — siempre ocurre en peores condiciones.

Teable: la base de datos NoCode en Rust con mantenimiento activo

undb vs Teable: comparativa técnica

Desplace la tabla

Preparar la migración: exportar desde undb

Exportar tus datos desde undb

1. 01

   Acceder a la interfaz de exportación

   En undb, abre cada tabla que quieras migrar. El menú contextual de la tabla (icono «…» o clic derecho en la pestaña) expone una opción «Export». undb ofrece dos formatos: CSV y JSON. Elige JSON para las tablas con campos de tipo relación o fórmula — el CSV aplana las relaciones en cadenas de texto, lo que complica el remapeo. Para tablas simples (sin relaciones), el CSV es suficiente.

2. 02

   Exportar tabla por tabla

   undb no ofrece una exportación global de base de datos en esta versión. Hay que exportar cada tabla por separado. Organiza tus archivos en una carpeta con el nombre de la base: por ejemplo export-undb-crm/. Anota el orden de importación futuro: las tablas referenciadas por otras deben importarse primero en Teable.

3. 03

   Verificar la integridad de las exportaciones

   Para cada archivo JSON exportado, verifica que no esté truncado: ábrelo en un editor o ejecuta python3 -m json.tool mi-export.json > /dev/null — sin salida de error indica JSON válido. Para archivos CSV, cuenta las líneas con wc -l export.csv y compara con el número de registros mostrado en undb.

4. 04

   Conservar una copia de archivo

   Antes de continuar, archiva todo: tar czf undb-export-$(date +%Y%m%d).tar.gz export-undb-*/. Conserva este archivo durante treinta días después de la migración. Si Teable revela una inconsistencia de datos dos semanas después de la importación, la exportación original de undb es tu referencia de verdad.

Instalar Teable en un VPS ServOrbit

Instalar Teable vía Docker Compose

1. 05

   Crear el directorio de trabajo

   Conéctate por SSH a tu VPS. Crea un directorio dedicado y navega hasta él:

   mkdir -p /opt/teable && cd /opt/teable

   Descarga el archivo Compose oficial:

   curl -O https://raw.githubusercontent.com/teableio/teable/main/dockers/docker-compose.yml

2. 06

   Configurar las variables de entorno

   Crea un archivo .env en /opt/teable/. Las variables mínimas requeridas son:

   POSTGRES_PASSWORD=cámbiame-fuerte
   TEABLE_SECRET_KEY=una-cadena-aleatoria-32-caracteres
   PUBLIC_ORIGIN=https://teable.tu-dominio.tld

   Genera la clave secreta con openssl rand -hex 16. No reutilices la contraseña de PostgreSQL de otra instancia.

3. 07

   Iniciar los servicios

   Lanza el stack en segundo plano:

   docker compose up -d

   Espera treinta segundos, luego verifica que los contenedores están en estado healthy:

   docker compose ps

4. 08

   Configurar el reverse proxy

   Teable escucha en el puerto 3000 por defecto. Configura tu reverse proxy (nginx o Caddy) para redirigir el tráfico HTTPS a localhost:3000. Ejemplo mínimo de nginx:

   server {
       listen 443 ssl;
       server_name teable.tu-dominio.tld;
       location / {
           proxy_pass http://127.0.0.1:3000;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
       }
   }

5. 09

   Primer acceso y creación de cuenta administrador

   Abre https://teable.tu-dominio.tld en un navegador. En el primer acceso, Teable propone crear una cuenta de administrador. Esta cuenta es local a tu instancia — sin registro externo. Elige una contraseña fuerte y guárdala en tu gestor de secretos.

6. 10

   Crear un espacio de trabajo

   Tras el login, crea un espacio de trabajo (equivalente a una organización en Airtable) que alojará las bases migradas desde undb. Dale un nombre descriptivo — Migración undb por ejemplo — para distinguir los datos importados de las nuevas bases que crearás directamente en Teable.

Importar tus datos de undb en Teable

Importar y verificar los datos

1. 11

   Crear la base destino en Teable

   En tu espacio de trabajo, haz clic en «Nueva base» y dale el mismo nombre que la base original en undb. Esta consistencia de nomenclatura facilita la verificación cruzada durante la migración.

2. 12

   Importar las tablas desde CSV o JSON

   Dentro de la base destino, haz clic en «+ Añadir tabla» y luego «Importar desde archivo». Selecciona tu exportación CSV o JSON. Para CSV, Teable detecta automáticamente los tipos de columna — verifica que las columnas de fecha se interpreten como Date y no como Text.

   Importa primero las tablas sin relaciones, luego las que las referencian.

3. 13

   Mapear y ajustar los tipos de campo

   Tras la importación, revisa cada columna en Teable y verifica su tipo. Puntos problemáticos comunes al migrar desde undb:
   - Los campos formula de undb llegan como valores calculados congelados — recrea las fórmulas en Teable manualmente.
   - Los campos attachment no migran por CSV; si undb almacenaba archivos, trátelos por separado.
   - Los campos booleanos exportados como cadena true/false deben convertirse al tipo Checkbox en Teable.

4. 14

   Verificar las relaciones y la integridad de los datos

   Si tus tablas de undb tenían relaciones (campos de tipo enlace), estas llegan aplanadas en la exportación CSV. Recrea los campos de enlace en Teable una vez importadas todas las tablas, luego usa la vista de filtrado para verificar que el número de registros coincide con el original.