Instalación

Requisitos del servidor: Linux (amd64 o arm64) con systemd, acceso root, salida a internet, y kernel ≥ 5.6 (o el módulo wireguard). El instalador instala Docker si falta.

curl -fsSL https://cloudweb.zondacloud.com/install.sh | sudo sh -s -- --base-domain apps.example.com --acme-email [email protected]

Opciones útiles:

Opción	Descripción
--public-host HOST	IP o nombre con que los demás nodos y tus usuarios alcanzan este servidor (se autodetecta)
--base-domain DOM	dominio base de las apps: cada app queda en <app>.DOM
--tls-mode MODE	auto (Let's Encrypt, por defecto), internal (CA local de Caddy) u off (sólo HTTP)
--acme-email EMAIL	contacto para Let's Encrypt
--name NAME	nombre del nodo (por defecto el hostname)
--no-ingress	este nodo no sirve tráfico HTTP(S) público (el nodo del servidor lo hace por defecto)
--skip-docker	no instalar Docker aunque falte

El instalador verifica el binario del servidor con SHA256SUMS, crea el servicio cloudweb-server y une este servidor como primer nodo ejecutando el instalador de cloud-web-node (node.sh, que instala el agente y su servicio cloudweb-agent). Es idempotente: volver a ejecutarlo actualiza o repara sin tocar tus datos ni tu configuración.

Al terminar imprime:

• la URL del dashboard (http://<host>:8080);
• la ubicación del token de administrador (/var/lib/cloudweb/admin.token), que sirve para configurar GitLab;
• el enlace de setup (de un solo uso) con el que la primera cuenta de GitLab pasa a ser administradora.

Después seguí con Tu primer deploy. Para el dominio y los puertos ver Red, puertos y DNS.

Qué instala

Pieza	Dónde	Rol
cloudweb-server	/usr/local/bin, usuario cloudweb	API, dashboard, scheduler y CA del clúster
cloudweb-agent	/usr/local/bin, root (lo instala node.sh)	malla WireGuard, contenedores, Caddy e imágenes
Datos del servidor	/var/lib/cloudweb (0700)	base SQLite, clave maestra, CA, token de admin
Configuración	/etc/cloudweb/server.env	variables de entorno del servidor