Instala Opfield

El instalador público prepara el host, instala Docker cuando hace falta, arranca el stack completo de Opfield y pasa la configuración al navegador. Una primera instalación normal no requiere que crees un archivo Compose ni que instales Docker a mano.

Elige un método de instalación

Método	Ideal para	Qué revisas y ejecutas
Instalador público (recomendado)	El camino compatible más corto y las actualizaciones normales en producción	Puedes inspeccionar el instalador o ejecutarlo en modo de prueba; instala Docker si hace falta, verifica los metadatos firmados de la versión y crea el stack completo
Instalación manual	Revisiones de seguridad que no permiten pasar un script descargado directamente a una shell	Instalas Docker, eliges la versión, inspeccionas la base de Compose, generas los secretos y arrancas cada servicio tú mismo; la verificación de digests es opcional

Ambos métodos despliegan la misma base de Opfield. Elige la instalación manual sin el script del instalador si tu política exige revisar por separado cada artefacto descargado y cada comando.

Lo que necesitas antes de empezar

Elige un host o una VM Linux dedicados que cumplan los requisitos de capacidad. La instalación automática de Docker admite las familias Debian, Ubuntu, Fedora, CentOS y RHEL. También necesitas:

una cuenta con acceso root o un sudo que funcione;
acceso saliente a internet hacia el servicio de actualizaciones de Opfield, el servicio de licencias (license.opfield.dev), los registros de contenedores y los repositorios de paquetes de Docker; Opfield se registra en el servicio de licencias tras su primer arranque, y una instalación que tiene o tuvo un plan de pago autoriza allí cada actualización;
curl y OpenSSL;
un plan para la URL definitiva de Opfield y su registro DNS;
acceso entrante al listener web y a la ruta de Relay descritos en Puertos y rutas de red.

No necesitas tener Docker Engine ni Docker Compose instalados de antemano. Si hay una instalación de Docker que funciona, el instalador la reutiliza. Si no, configura el repositorio oficial de paquetes de Docker, instala Docker Engine y el plugin Compose v2 y arranca el servicio de Docker. En hosts con paquetes de la distribución o de compatibilidad con Podman que entren en conflicto, el paso de instalación de Docker puede sustituir esos paquetes, así que usa un host dedicado a Opfield en lugar de una máquina con cargas de trabajo no relacionadas.

Instala Opfield

Conéctate al host seleccionado y ejecuta:

curl -fsSL https://get.opfield.dev | bash

En una instalación interactiva nueva, elige cómo debe escuchar Opfield en el puerto 3000:

HTTPS interno es la opción predeterminada. Opfield usa un certificado emitido por su propia System CA.
HTTP es adecuado cuando un proxy inverso de confianza termina TLS y el salto interno va sin cifrar deliberadamente.

En una instalación no interactiva, se selecciona HTTPS automáticamente. Puedes hacer la elección explícita:

# Internal HTTPS, also the default
curl -fsSL https://get.opfield.dev | bash -s -- --https

# HTTP behind a trusted TLS-terminating proxy
curl -fsSL https://get.opfield.dev | bash -s -- --http

Si quieres inspeccionar la versión firmada seleccionada y las acciones previstas sin cambiar el host, haz una ejecución de prueba:

curl -fsSL https://get.opfield.dev | bash -s -- --dry-run

Para servir la consola con un nombre público desde el principio, añade --domain y --acme-email a la vez:

curl -fsSL https://get.opfield.dev | bash -s -- --domain console.example.com --acme-email [email protected]

Opfield sirve entonces la consola en https://console.example.com en el puerto 443 con un certificado de Let’s Encrypt que obtiene mediante HTTP-01 en el puerto 80 y renueva por sí mismo. Por lo demás, el puerto 80 redirige a HTTPS y el puerto 3000 sigue funcionando. Hasta que el nombre apunte a este host, la consola en el puerto 443 usa el certificado de la System CA. La URL pública pasa a ser https://<domain>.

Para trasladar una instalación existente, --restore <file> instala en un directorio nuevo la versión de Opfield que generó una exportación de configuración y restaura allí la exportación; --public-url y --grpc-target fijan las direcciones del nuevo host sin preguntar.

Qué cambia el instalador

El directorio de instalación predeterminado es /opt/opfield y el proyecto Compose se llama opfield. El instalador verifica la versión seleccionada, escribe el entorno y la base de Compose, descarga las imágenes inmutables de la aplicación y de Relay, crea el almacenamiento persistente y arranca Opfield, PostgreSQL, Redis, el miembro local de Relay y el registro interno privado que requieren los flujos de build compatibles. PostgreSQL, Redis y el registro están fijados por digest y se descargan primero del mirror de imágenes de Opfield en ghcr.io, con Docker Hub como alternativa.

Trata este host como parte de la base de computación de confianza de Opfield. La aplicación recibe intencionadamente el control del host Docker para las actualizaciones firmadas, la recuperación, las tareas de mantenimiento y los servicios gestionados opcionales. Aísla Opfield en su propia VM o en un host de confianza dedicado; no coloques en él cargas de trabajo ni credenciales no relacionadas.

Termina en el navegador

Cuando el stack está en buen estado, el terminal muestra:

la URL que hay que abrir;
la huella de la System CA de Opfield;
un código de configuración de un solo uso válido durante 24 horas;
un comando de restablecimiento que emite un código sustituto si la configuración caduca.

El código de configuración en texto plano se muestra una sola vez y no se guarda en .env ni en la base de datos. Introdúcelo solo en la página de configuración de Opfield; no lo pegues en chats, tickets, logs ni capturas de pantalla. El asistente del navegador configura la URL canónica, los endpoints de la red de nodos, la autenticación, el primer administrador, el logging estructurado y, opcionalmente, AI Workspace. La configuración no necesita una licencia de pago; el logging estructurado permanece desactivado hasta que la licencia lo incluya (Business y Enterprise).

Continúa con Configuración inicial cuando termine el instalador.

Verifica la instalación

La instalación está completa cuando se abre la página de configuración en el navegador y el stack informa de que los servicios están en buen estado. Para una comprobación a nivel de operador:

cd /opt/opfield
sudo docker compose ps

Todos los servicios necesarios deben estar en ejecución. También puedes verificar el endpoint de estado local según el transporte seleccionado:

curl -kfsS https://127.0.0.1:3000/health
# or, for an HTTP installation:
curl -fsS http://127.0.0.1:3000/health

No añadas nodos de producción hasta que el asistente esté completo, la URL canónica sea correcta y un inicio de sesión normal funcione.

Si la instalación falla

Lee /tmp/opfield-install.log y el mensaje final del instalador antes de reintentar. Reintentar es seguro después de corregir un problema de red, de paquetes, de disco o de registro; el instalador detecta un despliegue existente gestionado por el instalador y conserva la configuración persistida de Opfield durante las actualizaciones. Una instalación nueva que se detuvo antes de mostrar el código de configuración se reanuda en la siguiente ejecución en lugar de tratarse como un despliegue existente.

Si se crearon los servicios pero Opfield no llegó a estar en buen estado, inspecciona el estado de Compose y unos logs acotados desde /opt/opfield en lugar de eliminar volúmenes o regenerar credenciales. Conserva .env, PostgreSQL, la identidad y el estado de Relay, el volumen app_data y la clave de cifrado maestra. Eliminar estos artefactos convierte un problema de instalación recuperable en una pérdida de datos o de identidad.