- Backend y frontend compilan correctamente.
- El flujo de creación/importación de bases ya levanta runtime libSQL por base.
- El rotate de token fue ajustado para recrear el contenedor con la nueva llave.
- Se agregó
backendConnectionUrlpara distinguir uso interno y uso para backend/producción.
- Validar en el despliegue real que el backend nuevo esté corriendo y no quede una imagen vieja cacheada.
- Confirmar que los contenedores libSQL nuevos ya no lean
SQLD_AUTH_JWT_KEY_FILEen logs. - Probar importación de SQLite en el entorno final con una base real.
- Probar rotate token en el entorno final y verificar que:
- el token nuevo se muestra,
- el runtime queda activo,
- la conexión sigue funcionando.
- Definir una URL pública estable para producción:
DATABASE_PUBLIC_URL_TEMPLATE, oDATABASE_PUBLIC_BASE_URL, oDATABASE_PUBLIC_HOSTreal.
- Verificar que
Public URLno se confunda conBackend URL. - Verificar que
Internal URLsea resoluble solo dentro de la red Docker. - Verificar que
Backend URLsea el valor recomendado para el backend del usuario. - Verificar
POST /api/v1/databases/import-uploadcon archivo real. - Verificar
POST /api/v1/databases/import-sqlitecon ruta real del servidor. - Verificar
POST /api/v1/databases/:id/test-connectiondespués de create/import/rotate. - Verificar
DELETE /api/v1/databases/:idlimpia contenedor y archivos asociados.
- Redeploy limpio del backend.
- Redeploy limpio del frontend.
- Si aplica, borrar contenedores fallidos de libSQL.
- Confirmar variables de entorno en el entorno final:
MASTER_KEYDATABASE_FILESQLITE_STORAGE_ROOTDATABASE_PUBLIC_HOSTDATABASE_PUBLIC_PROTOCOLDOCKER_SOCKET_PATHLIBSQL_SERVER_IMAGE
- Si el backend sigue mostrando logs antiguos, el problema es un artefacto desplegado viejo.
- Si
DATABASE_PUBLIC_HOSTapunta a localhost/127.0.0.1 en producción, las URLs no serán útiles fuera del contenedor. - Si Coolify o Docker no comparten red correctamente,
internalUrlpuede no servir para backend remoto. - Si el runtime libSQL falla por auth, el log deberá revisarse en el contenedor recién creado.
- Hacer redeploy limpio.
- Crear una base nueva de prueba.
- Importar una SQLite real.
- Rotar el token.
- Confirmar qué URL usarás desde tu backend real.
- Si algo falla, guardar el log exacto del contenedor y corregir solo ese punto.