Guía de despliegue

Teable en VPS: Alternativa Open Source a Airtable

Desplegar en un VPS Cloud →

Teable en VPS: Alternativa Open Source a Airtable

Autoalojamiento4 min de lectura

Teable es una plataforma de bases de datos colaborativas open source (AGPL-3.0, más de 21k estrellas en GitHub) que lleva la experiencia de Airtable a tu propio VPS. A diferencia de las herramientas alojadas en la nube, cada tabla se almacena directamente en PostgreSQL, con acceso SQL completo y portabilidad total de datos.

Contenido· Por qué autoalojar Teable en lugar de usar una solución en la nube1/7
  1. 01Por qué autoalojar Teable en lugar de usar una solución en la nube
  2. 02Qué obtienes con Teable autoalojado en un VPS de ServOrbit
  3. 03Arquitectura de despliegue — tres contenedores Docker coordinados
  4. 04Teable vs NocoDB vs Grist — cuál elegir según tu caso de uso
  5. 05Primer despliegue en ServOrbit — pasos de activación
  6. 06Usando la API REST autogenerada para integraciones
  7. 07Actualizar y mantener Teable a largo plazo

Por qué autoalojar Teable en lugar de usar una solución en la nube

Las herramientas al estilo Airtable alojadas en la nube comparten tres limitaciones estructurales: tus datos viven en servidores de terceros fuera de tu control, el precio escala directamente con el número de usuarios o filas lo que encarece el crecimiento, y el acceso SQL directo suele estar bloqueado detrás de planes de pago más altos.

Teable elimina las tres de un golpe. Instalado en tu VPS, crea sus propias tablas PostgreSQL desde cero — no es un envoltorio gráfico sobre una base existente, sino un esquema propio que puedes consultar con cualquier cliente SQL o herramienta BI. Las actualizaciones en tiempo real usan WebSockets: varios colaboradores editan la misma tabla simultáneamente sin necesidad de recargar. Y al ser AGPL-3.0, ningún dato abandona tu infraestructura.

Qué obtienes con Teable autoalojado en un VPS de ServOrbit

  • Almacenamiento nativo en PostgreSQL — tus tablas viven en tu propia base de datos, accesibles vía SQL o cualquier herramienta BI como Metabase o Grafana.
  • Colaboración en tiempo real — múltiples editores simultáneos, cambios visibles al instante vía WebSocket sin recarga de página.
  • Vistas múltiples sobre los mismos datos — Cuadrícula, Kanban, Galería y Formulario sin duplicar registros ni crear copias paralelas.
  • API REST autogenerada por cada tabla, con token de acceso listo para usar en n8n, Zapier o tu propio código backend.
  • Motor de fórmulas completo — 100+ funciones matemáticas, lógicas y de texto para campos calculados y referencias cruzadas entre tablas.
  • Permisos granulares personalizables — roles visualizador, editor o propietario por espacio de trabajo, base o tabla individualmente.
  • Licencia AGPL-3.0 de código abierto — sin telemetría, sin cuenta cloud requerida, datos 100% en tu VPS.

Arquitectura de despliegue — tres contenedores Docker coordinados

Teable corre en tu VPS con tres contenedores Docker coordinados:

- teable-db: PostgreSQL 15.4 con volumen nombrado teable-db para garantizar la persistencia de datos entre reinicios.
- teable-cache: Redis 7.2.4 con persistencia AOF y contraseña de autenticación en cada conexión.
- teable: el servidor de aplicación basado en Next.js + NestJS, escuchando en el puerto 3000 en loopback, expuesto por nginx con HTTPS.

La variable PUBLIC_ORIGIN ancla la URL pública de la instancia — ServOrbit la inyecta automáticamente desde el subdominio o dominio personalizado que hayas configurado. BACKEND_SESSION_ORIGIN_CHECK_ENABLED=false garantiza la compatibilidad con el proxy inverso nginx sin conflictos de verificación de origen. Todas las imágenes están fijadas a versiones exactas para despliegues reproducibles.

Teable vs NocoDB vs Grist — cuál elegir según tu caso de uso

Las tres herramientas del catálogo de ServOrbit cubren necesidades distintas:

- NocoDB conecta a una base de datos PostgreSQL o MySQL existente y la envuelve en una interfaz colaborativa visual. Ideal cuando ya tienes un esquema y quieres añadir una interfaz sin reestructurar los datos.
- Grist usa un modelo de documento con fórmulas Python más potentes que una hoja de cálculo clásica, perfecto para analistas que necesitan cálculos complejos.
- Teable crea sus propias tablas PostgreSQL desde cero y se centra en la colaboración visual en tiempo real. Es la más cercana a la experiencia Airtable en apariencia y uso, con la ventaja de la portabilidad SQL completa.

Las tres pueden ejecutarse en instancias VPS separadas simultáneamente si tus necesidades lo requieren.

Primer despliegue en ServOrbit — pasos de activación

Desde tu área de cliente de ServOrbit, abre Marketplace → Bases de datos → Teable y confirma el pedido. ServOrbit provisiona un VPS nuevo, instala Docker e inicia los tres contenedores automáticamente. Recibirás una notificación por correo electrónico cuando la instalación se complete con la URL de acceso.

Navegando a esa URL aparece la página de registro de Teable — la primera cuenta que crees se convierte automáticamente en propietaria del espacio de trabajo. No existe una cuenta de administrador predefinida por ServOrbit: tú eliges el nombre de usuario y contraseña en ese primer registro. Haz clic en New Base, nombra tu base, define tus tablas y columnas, y empieza a invitar colaboradores desde los ajustes del espacio de trabajo.

Usando la API REST autogenerada para integraciones

Cada tabla de Teable expone automáticamente una API REST completamente funcional. Para usarla, abre Settings → API Tokens en la interfaz de Teable y genera un token de acceso. La API sigue las convenciones REST estándar para lectura, escritura, modificación y eliminación:

GET /api/table/{tableId}/record
POST /api/table/{tableId}/record
PATCH /api/table/{tableId}/record/{recordId}
DELETE /api/table/{tableId}/record/{recordId}

Conecta esta API directamente a n8n, Zapier, Make o tu propia aplicación backend para automatizar actualizaciones de datos, importar respuestas de formularios o sincronizar registros con otros servicios como CRM o ERP.

Actualizar y mantener Teable a largo plazo

Para actualizar Teable a una versión más reciente, edita la receta Docker para referenciar el nuevo tag de imagen de ghcr.io/teableio/teable:<nuevo-tag> y reinicia con dos comandos:

docker compose pull
docker compose up -d

Teable ejecuta sus migraciones de esquema PostgreSQL automáticamente al arrancar — tus datos en el volumen teable-db se conservan íntegros en cada actualización. Consulta siempre la [página de releases de GitHub](https://github.com/teableio/teable/releases) para obtener el tag más estable y las notas de actualización antes de aplicar. Se recomienda hacer una copia de seguridad de PostgreSQL antes de cada actualización mayor.

Despliega Teable en tu VPS de ServOrbit

Base de datos colaborativa open source, API REST autogenerada, tus datos en tu servidor.

¿Necesita ayuda?

Consulte nuestro centro de ayuda y nuestra FAQ, o contacte con nuestro equipo: llamada, WhatsApp o correo electrónico. Soporte en francés, inglés y árabe.

Escribir por WhatsAppse abre en una pestaña nueva