Migrer de undb vers Teable sur VPS ServOrbit

Le problème avec undb en 2025-2026

Pourquoi migrer maintenant et pas dans six mois

• Risque sécurité actif : les dépendances npm non mises à jour accumulent des CVE connues ; un undb exposé sur Internet sans reverse proxy durci représente une surface d'attaque croissante.
• Bugs non corrigés en production : les régressions sur l'import CSV et les formules signalées fin 2025 ne trouvent pas de correctif ; si votre usage touche ces fonctionnalités, la situation empire avec le temps.
• Dépendances gelées : Node.js LTS avance, Docker base images changent ; un projet sans maintenance finit par ne plus se builder, ce qui bloque les mises à jour de sécurité de l'hôte.
• Communauté qui migre : les discussions dans les forums self-hosted (Reddit r/selfhosted, awesome-selfhosted issues) indiquent un mouvement clair vers Teable, NocoDB et Grist ; rester sur undb, c'est s'isoler des retours d'expérience et des scripts d'intégration actifs.
• Données orphelines : plus le temps passe, plus la probabilité d'un changement de schéma interne non documenté augmente ; exporter aujourd'hui, quand le format de sortie est connu et stable, est plus sûr qu'attendre une incompatibilité future.
• Fenêtre de migration propre : vos données sont encore fraîches et cohérentes ; une migration forcée en urgence — parce que l'instance ne démarre plus après une mise à jour Docker — se fait toujours dans de moins bonnes conditions.

Teable : la base de données NoCode en Rust activement maintenue

undb vs Teable : comparatif technique

Faites défiler le tableau

Préparer la migration : exporter depuis undb

Exporter vos données depuis undb

1. 01

   Accéder à l'interface d'export

   Dans undb, ouvrez chaque table que vous souhaitez migrer. Le menu contextuel de la table (icône « … » ou clic droit sur l'onglet) expose une option « Export ». undb propose deux formats : CSV et JSON. Choisissez JSON pour les tables avec des champs de type relation ou formule — le CSV aplatit les relations en chaînes, ce qui complique le remappage. Pour les tables simples (données tabulaires sans relations), le CSV est suffisant.

2. 02

   Exporter table par table

   undb n'offre pas d'export global de base à cette version. Il faut exporter chaque table séparément. Organisez vos fichiers dans un dossier nommé d'après la base : par exemple export-undb-crm/, export-undb-projets/. Notez l'ordre d'import futur : les tables référencées par d'autres doivent être importées en premier dans Teable.

3. 03

   Vérifier l'intégrité des exports

   Pour chaque fichier JSON exporté, vérifiez qu'il n'est pas tronqué : ouvrez-le dans un éditeur ou lancez python3 -m json.tool mon-export.json > /dev/null — une sortie sans erreur indique un JSON valide. Pour les CSV, comptez les lignes avec wc -l export.csv et comparez au nombre d'enregistrements affiché dans undb. Un écart de plus de quelques lignes (headers, ligne vide finale) mérite investigation avant de continuer.

4. 04

   Conserver une copie d'archive

   Avant de poursuivre, archivez l'ensemble : tar czf undb-export-$(date +%Y%m%d).tar.gz export-undb-*/. Conservez cette archive trente jours après la migration. Si Teable révèle une incohérence de données deux semaines après l'import, l'export undb original est votre référence de vérité.

Installer Teable sur un VPS ServOrbit

Installer Teable via Docker Compose

1. 05

   Créer l'arborescence de travail

   Connectez-vous en SSH à votre VPS. Créez un dossier dédié et placez-vous dedans :

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

   Téléchargez le fichier Compose officiel depuis le dépôt Teable :

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

2. 06

   Configurer les variables d'environnement

   Créez un fichier .env dans /opt/teable/. Les variables minimales sont :

   POSTGRES_PASSWORD=changez-moi-fort
   TEABLE_SECRET_KEY=une-chaine-aleatoire-32-caracteres
   PUBLIC_ORIGIN=https://teable.votre-domaine.tld

   Générez la clé secrète avec openssl rand -hex 16. Ne réutilisez pas le mot de passe PostgreSQL d'une autre instance.

3. 07

   Démarrer les services

   Lancez la stack en arrière-plan :

   docker compose up -d

   Attendez trente secondes, puis vérifiez que les conteneurs sont en état healthy :

   docker compose ps

   Le service teable doit afficher healthy. Si teable-db n'est pas encore prêt, attendez quelques secondes supplémentaires — la base PostgreSQL met plus de temps au premier démarrage (initialisation des schémas).

4. 08

   Configurer le reverse proxy

   Teable écoute sur le port 3000 par défaut. Configurez votre reverse proxy (nginx ou Caddy) pour rediriger le trafic HTTPS vers localhost:3000. Exemple nginx minimal :

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

   Si vous utilisez le template ServOrbit, cette configuration est générée automatiquement.

5. 09

   Premier accès et création du compte administrateur

   Ouvrez https://teable.votre-domaine.tld dans un navigateur. À la première connexion, Teable propose de créer un compte administrateur. Ce compte est local à votre instance — il n'y a pas d'enregistrement externe. Choisissez un mot de passe fort et notez-le dans votre gestionnaire de secrets.

6. 10

   Créer un espace de travail

   Après connexion, créez un espace de travail (équivalent d'une organisation dans Airtable) qui accueillera vos bases migrées depuis undb. Donnez-lui un nom explicite — Migration undb par exemple — pour distinguer les données importées des nouvelles bases que vous créerez directement dans Teable.

Importer vos données undb dans Teable

Importer et vérifier les données

1. 11

   Créer la base cible dans Teable

   Dans votre espace de travail, cliquez sur « Nouvelle base » et donnez-lui le même nom que la base d'origine dans undb. Cette cohérence de nommage facilite la vérification croisée pendant la migration. Si vous migrez plusieurs bases, traitez-les une par une.

2. 12

   Importer les tables depuis CSV ou JSON

   Dans la base cible, cliquez sur « + Ajouter une table » puis « Importer depuis un fichier ». Sélectionnez votre export CSV ou JSON. Pour un CSV, Teable détecte automatiquement les types de colonnes — vérifiez que les colonnes de date sont bien interprétées comme Date et non comme Texte. Pour un JSON, le mapping est plus direct si le format d'export undb est standard.

   Importez d'abord les tables sans relations (les tables « feuilles » dans votre graphe de données), puis celles qui les référencent.

3. 13

   Mapper et ajuster les types de champs

   Après import, parcourez chaque colonne dans Teable et vérifiez son type. Les points d'attention courants depuis undb :
   - Les champs formula d'undb n'ont pas d'équivalent direct à l'import — ils arrivent comme valeurs calculées figées. Recréez les formules dans Teable manuellement.
   - Les champs attachment ne migrent pas par CSV ; si undb stockait des fichiers, traitez-les séparément.
   - Les champs booléens exportés comme true/false en chaîne de caractères doivent être reconvertis en type Checkbox dans Teable.

4. 14

   Vérifier les relations et l'intégrité des données

   Si vos tables undb avaient des relations (champs de type « lien »), celles-ci arrivent aplaties dans l'export CSV. Recréez les champs de liaison dans Teable une fois toutes les tables importées, puis utilisez la vue de filtrage pour vérifier que le nombre d'enregistrements correspond à l'original. Un écart persistant indique un problème d'encodage dans l'export (caractères spéciaux, fins de ligne Windows) — ré-exportez avec l'option JSON dans ce cas.