Ingot sin interfaz (ingot serve)
Ingot sin interfaz (headless) ejecuta el IDE completo de Ingot en tu propio servidor, VM o equipo de casa, sin escritorio ni ventana. Inícialo con ingot serve y abre el proyecto como Ingot Web desde cualquier navegador en ingotide.com/w/<id>: los mismos archivos, editores, terminales, agentes y chat que en la app de escritorio.
- La misma cuenta. Inicias sesión en ingotide.com con tu cuenta de Ingot, como en el escritorio.
- El mismo plan. Una solicitud desde Ingot Web cuenta igual que una desde la app de escritorio: el mismo uso y los mismos límites.
- Proyectos web del plan. Cada carpeta que sirves es un proyecto web y usa uno de los proyectos web de tu plan (Bronze 3, Silver 5, Gold 7). Consulta Límites y precios.
Nada se ejecuta en la nube de Ingot por ti. El IDE se ejecuta en tu máquina y mantiene una conexión saliente y cifrada con el relay de Ingot, que reenvía tu navegador hacia ella. No abres ningún puerto de entrada.
Descarga
Descarga el paquete de tu servidor en Descargar › Ingot sin interfaz. Los paquetes se publican con cada versión de Ingot, desde el mismo sitio que los instaladores de escritorio. Una plataforma que aún no tiene paquete publicado muestra Llega con la primera versión, sin enlace.
| Servidor | Paquete |
|---|---|
| Linux x64 | ingot-server-<version>-linux-x64.tar.gz |
| Linux arm64 | ingot-server-<version>-linux-arm64.tar.gz |
| macOS (Apple Silicon) | ingot-server-<version>-mac-arm64.tar.gz |
| macOS (Intel) | ingot-server-<version>-mac-x64.tar.gz |
| Windows | Aún no hay paquete. Usa el paquete de Linux x64 en WSL 2. |
Cada paquete incluye el backend del IDE (con sus módulos nativos para ese sistema y arquitectura), el frontend web, los plugins de lenguaje y bin/ingot-server. Necesita Node.js 22 en el servidor.
En macOS, si la descarga queda en cuarentena, ejecuta una vez xattr -dr com.apple.quarantine <carpeta>.
Inicio rápido
- Instala la CLI ingot (Node.js 22):
npm install -g @ingotide/cli. - Descomprime el paquete, por ejemplo en
/opt. - En el panel, abre Publicador › Tokens y crea un token con Servir proyectos web (ingot serve) (permiso
web:serve). - Ejecuta
ingot servecon la carpeta del proyecto:
tar -xzf ingot-server-<version>-linux-x64.tar.gz -C /opt
export INGOT_SERVE_APP=/opt/ingot-server-<version>-linux-x64
export INGOT_WEB_TOKEN=ingot_pub_...
ingot serve ~/shop --name "Shop"
- Abre el proyecto desde Proyectos web en tu panel, o en el enlace que muestra
ingot serve. Inicia sesión con la misma cuenta y se abre el IDE completo.
El proyecto sigue en línea hasta que detienes ingot serve (Ctrl+C). Ingot escucha solo en 127.0.0.1 (puerto 3100, o --port); el relay lo alcanza desde la propia máquina.
| Opción | Por defecto |
|---|---|
[carpeta] | La carpeta actual |
--port <puerto> | 3100 (solo local) |
--name <nombre> | name en .ingot/web.json, después el nombre de la carpeta |
--app <dir> | INGOT_SERVE_APP |
--token <token> | INGOT_WEB_TOKEN, después INGOT_PUBLISH_TOKEN, después ingot login |
Los ajustes para compartir de un proyecto (rol por defecto, puerto de vista previa, correos permitidos, caducidad del enlace) vienen de su .ingot/web.json, como en el escritorio.
Publicación desatendida
ingot serve inicia bin/ingot-server con algunas variables de entorno. Puedes definirlas tú e iniciar bin/ingot-server directamente, por ejemplo desde systemd, sin la CLI:
| Variable | Significado |
|---|---|
INGOT_WEB_PUBLISH | 1 publica la carpeta como proyecto web en cuanto Ingot arranca |
INGOT_WEB_PROJECT | La carpeta que se publica |
INGOT_WEB_TOKEN | Un token de publicador con el permiso web:serve |
INGOT_WEB_NAME | Nombre del proyecto, opcional (por defecto: .ingot/web.json, después el nombre de la carpeta) |
INGOT_PORT | Puerto local (por defecto 3100, siempre en 127.0.0.1) |
INGOT_NODE | El binario de Node.js 22, si node en el PATH es otra versión |
Volver a publicar la misma carpeta desde la misma máquina reutiliza su proyecto web; no ocupa un nuevo hueco.
Mantenerlo en marcha con systemd
# /etc/systemd/system/ingot-shop.service
[Unit]
Description=Headless Ingot (shop)
After=network-online.target
Wants=network-online.target
[Service]
User=dev
WorkingDirectory=/home/dev/shop
EnvironmentFile=/etc/ingot/shop.env
ExecStart=/opt/ingot-server/bin/ingot-server /home/dev/shop
Restart=on-failure
[Install]
WantedBy=multi-user.target
# /etc/ingot/shop.env (sudo chmod 600: solo root lo lee; systemd lo pasa al servicio)
INGOT_WEB_PUBLISH=1
INGOT_WEB_PROJECT=/home/dev/shop
INGOT_WEB_NAME=Shop
INGOT_WEB_TOKEN=ingot_pub_...
INGOT_PORT=3100
Después sudo systemctl enable --now ingot-shop, y journalctl -u ingot-shop -f para los registros. Para usar la CLI, define INGOT_SERVE_APP e INGOT_WEB_TOKEN en el archivo de entorno y usa ExecStart=/usr/bin/ingot serve /home/dev/shop.
Docker
Imagen de Docker: prevista. Aún no hay imagen oficial; por ahora usa el paquete con systemd.
Seguridad
- Solo el propietario. Solo la cuenta que publicó un proyecto lo abre como IDE completo. Cualquier otra persona con un enlace para compartir obtiene como mucho el visor de solo lectura: sin terminal, agentes ni ajustes, y sin archivos que parezcan secretos.
- Tokens.
ingot servese autentica con un token de publicador, como al publicar una extensión. Dale solo el permisoweb:serve, mantenlo fuera del historial del shell y de archivos legibles por todos (usaEnvironmentFile=con modo 600) y revócalo en Publicador › Tokens si se filtra. Los tokens caducan. - El relay no guarda código. El código pasa por el relay de Ingot y nunca se guarda en el servidor de Ingot. El servidor solo guarda el nombre del proyecto, sus ajustes para compartir y cuándo estuvo activo por última vez.
- TLS, no de extremo a extremo. El tráfico va cifrado en tránsito con TLS entre tu servidor y el relay, y entre el relay y tu navegador. No está cifrado de extremo a extremo: el relay lo descifra para reenviarlo y no lo conserva.
- Solo local. Ingot escucha en
127.0.0.1. No expongas su puerto; la conexión con el relay es saliente. - Ejecútalo como usuario normal. El IDE completo (terminal y agentes incluidos) se ejecuta como el usuario del servicio, así que usa una cuenta sin privilegios que solo alcance lo que el proyecto necesita.
- Detenlo cuando quieras. Detén el servicio, usa Detener o Eliminar en el panel, o revoca el token. Consulta Seguridad de Ingot Web para el acceso de corta duración y los límites de frecuencia.
Solución de problemas
| Problema | Qué hacer |
|---|---|
| "The Ingot server build was not found" | Apunta --app o INGOT_SERVE_APP a la carpeta descomprimida (tiene lib/backend/main.js). |
| "Ingot server needs Node.js 22" | Instala Node.js 22 o define INGOT_NODE con su binario. |
| El token no tiene permiso web | Crea un token con web:serve en Publicador › Tokens. |
| "Web projects are all in use" | Añade un proyecto extra o elimina uno en Proyectos web. |
| El enlace dice sin conexión | Comprueba que el servicio está en marcha (systemctl status ingot-shop) y que la máquina llega a internet. |
Los archivos .ts se abren como texto plano | Faltan los plugins de lenguaje en la carpeta del paquete; descárgalo de nuevo. |