Beta Próximamente. Esta función aún está en desarrollo; los nombres y detalles pueden cambiar antes del lanzamiento.

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.

ServidorPaquete
Linux x64ingot-server-<version>-linux-x64.tar.gz
Linux arm64ingot-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
WindowsAú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

  1. Instala la CLI ingot (Node.js 22): npm install -g @ingotide/cli.
  2. Descomprime el paquete, por ejemplo en /opt.
  3. En el panel, abre Publicador › Tokens y crea un token con Servir proyectos web (ingot serve) (permiso web:serve).
  4. Ejecuta ingot serve con 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"
  1. 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ónPor 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:

VariableSignificado
INGOT_WEB_PUBLISH1 publica la carpeta como proyecto web en cuanto Ingot arranca
INGOT_WEB_PROJECTLa carpeta que se publica
INGOT_WEB_TOKENUn token de publicador con el permiso web:serve
INGOT_WEB_NAMENombre del proyecto, opcional (por defecto: .ingot/web.json, después el nombre de la carpeta)
INGOT_PORTPuerto local (por defecto 3100, siempre en 127.0.0.1)
INGOT_NODEEl 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 serve se autentica con un token de publicador, como al publicar una extensión. Dale solo el permiso web:serve, mantenlo fuera del historial del shell y de archivos legibles por todos (usa EnvironmentFile= 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

ProblemaQué 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 webCrea 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ónComprueba 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 planoFaltan los plugins de lenguaje en la carpeta del paquete; descárgalo de nuevo.