Files
engram-wiki/02-nuevo-proyecto-cloud.md
2026-05-03 17:02:28 +02:00

87 lines
2.2 KiB
Markdown

# Engram — Añadir nuevo proyecto al cloud
Pasos para registrar un nuevo proyecto en Engram Cloud.
---
## 1. En el VPS — Permitir el proyecto
Edita el docker-compose:
```bash
nano /opt/engram/docker-compose.cloud.yml
```
Añade el nuevo proyecto a la variable `ENGRAM_CLOUD_ALLOWED_PROJECTS`:
```yaml
ENGRAM_CLOUD_ALLOWED_PROJECTS: smoke-project,planificacion_proyectos,gestion-talleres-2000,NOMBRE_NUEVO_PROYECTO
```
Reinicia el contenedor para aplicar los cambios:
```bash
docker compose -f docker-compose.cloud.yml up -d --force-recreate cloud
```
---
## 2. En tu PC — Enrollar y sincronizar
```powershell
engram cloud enroll NOMBRE_NUEVO_PROYECTO
cmd /c "set ENGRAM_CLOUD_TOKEN=TOKEN && engram sync --cloud --project NOMBRE_NUEVO_PROYECTO"
```
---
## Notas
- El nombre del proyecto se normaliza automáticamente a minúsculas con guiones bajos. Por ejemplo `PLANIFICACION_PROYECTOS``planificacion_proyectos`
- Cada proyecto tiene su propia memoria aislada en el cloud
- El dashboard muestra todos los proyectos en `https://engram.v-encore-lab.com/dashboard/`
## Script automático (recomendado)
Usa el script `engram-sync.bat` que automátiza el proceso:
```powershell
C:\Users\juanm\Documents\engram-wiki\engram-sync.bat [proyecto] [token]
```
Por defecto usa `engram-wiki` y el token guardado.
```powershell
C:\Users\juanm\Documents\engram-wiki\engram-sync.bat
```
---
## Si el sync falla por mutaciones legacy
### Solución:清洁ar cloud_upgrade_state (más efectivo)
```powershell
C:\Users\juanm\Downloads\sqlite3.exe C:\Users\juanm\.engram\engram.db "DELETE FROM cloud_upgrade_state WHERE project = 'NOMBRE_PROYECTO';"
```
### Luego re-sync
```powershell
cmd /c "set ENGRAM_CLOUD_TOKEN=TOKEN && engram sync --cloud --project NOMBRE_PROYECTO"
```
---
### Alternativa: Upgrade doctor + repair
```powershell
cmd /c "set ENGRAM_CLOUD_TOKEN=TOKEN && engram cloud upgrade doctor --project NOMBRE_PROYECTO"
cmd /c "set ENGRAM_CLOUD_TOKEN=TOKEN && engram cloud upgrade repair --project NOMBRE_PROYECTO --apply"
```
### SQLite directa (si repair no funciona)
```powershell
C:\Users\juanm\Downloads\sqlite3.exe C:\Users\juanm\.engram\engram.db "DELETE FROM sync_mutations WHERE entity = 'relation' AND project = 'NOMBRE_PROYECTO';"
```