Ligbox Spec Hub f6cf9f8e1c Add Spec 034 Nextcloud integration with VM112 Carbonio mail.

Defines hybrid hot/warm storage to expand tenant mail capacity via Nextcloud Hub on proposed VM116.

2026-06-20 22:07:00 +00:00

2.8 KiB

Raw Blame History

Quickstart — Piloto Nextcloud + Carbonio VM112 (Spec 034)

Público: ops_lead, super_admin
Pré-requisito: VM116 provisionada · Carbonio VM112 operacional · acesso CT114

Regra operacional

Carbonio continua MTA. Nextcloud não altera MX/DKIM.
Piloto começa com 1 domínio de teste (não ligbox.com.br produção até validar).

1. Verificar Carbonio VM112

ssh root@10.10.10.112 -p 2512   # via Proxmox jump se necessário

# Conta teste
zmprov ga admin@DOMINIO-TESTE.com zimbraMailQuota 2>/dev/null | head -5

# IMAP local
openssl s_client -connect 127.0.0.1:993 -quiet </dev/null 2>&1 | head -3

2. Instalar Nextcloud VM116 (piloto)

ssh root@10.10.10.116

# Após clone repo + deploy/vm116-nextcloud/
cd /opt/ligbox-ops-platform/deploy/vm116-nextcloud
cp .env.example .env
# Editar: NC_DOMAIN=cloud.ligbox.com.br, ADMIN_PASS=***
docker compose up -d

docker exec -u www-data nextcloud occ status

URL piloto: https://cloud.ligbox.com.br

3. Criar utilizador Nextcloud (= e-mail Carbonio)

docker exec -u www-data nextcloud occ user:add \
  --display-name="Admin Teste" \
  --password-from-env \
  admin@DOMINIO-TESTE.com

docker exec -u www-data nextcloud occ user:setting \
  admin@DOMINIO-TESTE.com files quota 25GB

Importante: usar o mesmo e-mail que existe no Carbonio.

4. Configurar Mail app (Nextcloud → Carbonio)

No browser, login Nextcloud como admin@DOMINIO-TESTE.com:

Activar app Mail
Nova conta:
- E-mail: admin@DOMINIO-TESTE.com
- IMAP: mail.DOMINIO-TESTE.com · port 993 · SSL
- SMTP: mail.DOMINIO-TESTE.com · port 587 · STARTTLS
- Utilizador/senha: credenciais Carbonio
Enviar e-mail teste → verificar recepção no webmail Carbonio.

5. Teste capacidade (Files vs Mail)

# Upload ficheiro 50 MB no Files — deve funcionar
# Verificar quota Carbonio não aumentou:
ssh root@10.10.10.112 "zmprov gq admin@DOMINIO-TESTE.com"

6. Traefik — files.{dominio} (opcional piloto)

No CT114, seguir template Spec 017 para mail.{dom} substituindo backend por 10.10.10.116:443.

Teste:

curl -sI "https://files.DOMINIO-TESTE.com/status.php" | head -5

7. Desk — health (após implementação API)

curl -s -u root:805353 \
  "http://10.10.10.122:8180/api/v1/nextcloud/health" | jq .

Checklist piloto OK

Nextcloud status 200
User NC criado com e-mail @dominio
Mail app lê Inbox Carbonio
Envio SMTP funciona
Upload 50 MB em Files OK
Quota Carbonio inalterada após upload Files
ops_lead aprova continuar Fase 1 (wizard)

Rollback piloto

docker exec -u www-data nextcloud occ user:delete admin@DOMINIO-TESTE.com
# Remover router Traefik files.{dom} se criado

2.8 KiB Raw Blame History