Beta Coming soon. This feature is still being built, so names and details may change before it ships.

Web projects (Ingot Web)

New: Ingot in your browser. The easiest way to use Ingot Web needs nothing running anywhere: open a folder, a GitHub repo or a scratch project in the editor that runs right in your browser. See Ingot in your browser. This page covers the advanced way: the full IDE served by your own machine.

Ingot Web is the full Ingot IDE in your browser, served by your own running Ingot: the desktop app, or ingot serve on a server, VM or dev box. A Web project is a project published that way, with a link. You open it at ingotide.com/w/<id> as the full IDE, and you can share a view-only link, like a sandbox preview, while the code stays on your machine.

One plan covers the desktop app, Ingot Web and the mobile app: one account, one price, the same usage and limits everywhere. A request from the web counts exactly like one from the desktop.

Every plan can use Ingot Web. Free includes 1 Web project with AI off; Bronze, Silver and Gold include 3, 5 and 7 with AI on. See AI on your plan.

Use Ingot in your browser: ingotide.com/web

ingotide.com/web is the easiest way in. Sign in with your Ingot account and it lists your machines that serve Ingot Web, online or offline, with when each was last seen and its Ingot version, and the projects on each one:

  • Open opens the project as the full IDE in a new tab (the machine must be online).
  • Open on phone shows a QR code of the project link. Scan it with your phone's camera and sign in with the same account to open the same project there.
  • Start Ingot on <machine> shows when a machine is offline: open Ingot there (or start ingot serve) and the project comes back.
  • Version mismatch means that machine's Ingot is too old to connect to the relay: update Ingot there. An older but working version says Update Ingot on <machine>.
  • All your Web projects are in use shows when you reach your plan's allowance, with Manage projects and, on Free, See plans (on a paid plan, Add a project).

No machine yet? The page shows the two ways to start: On this computer (download the app, turn on Settings › Ingot Web, run Open on the Web) and On a server (ingot serve, see below).

How it works

  • The IDE runs on your computer. Nothing runs in the Ingot cloud for you: no container, no copy of your code.
  • Your Ingot keeps one encrypted connection (a WebSocket tunnel) open to the Ingot relay. When you open the project in a browser, the relay forwards the browser to your own Ingot: the same files, editors, terminals, agents and chat.
  • The desktop window and the web window are two windows of the same Ingot, so they stay in step: what you type in one shows in the other as you type, before you save.
  • Code passes through the Ingot relay encrypted in transit (TLS) and is never stored on the Ingot server. The server keeps only the project's name, its share settings and when it was last active.

Turn it on in the desktop app

  1. Sign in to Ingot.
  2. Turn on Settings › Ingot Web (setting ingot.web.enabled, off by default). It is a user setting only: a repository's settings can never share your computer.
  3. Run Ingot Web: Open on the Web from the command palette, or click the Web item in the status bar.

The first time you turn Ingot Web on, a short guide explains who serves it (this computer), how to open it (Open on the Web, or ingotide.com/web later, with a QR code for your phone) and what your plan includes in the browser. It shows once per computer.

Ingot publishes the open folder as a Web project and opens ingotide.com/w/<id> in your browser. Sign in there with the same account and the IDE opens, connected live to your computer. The status bar item shows Web: live while the project is online; click it for Copy Share Link, Stop Sharing to Web and Manage Web Projects.

Stop Sharing to Web closes every web tab and every share link at once. Run Open on the Web again to share it again; it keeps the same project (no new slot).

From the desktop app

Open on the Web works from the Mac, Windows and Linux desktop app. The desktop app ships the web version of its own window and serves it to your browser through the Ingot relay, so ingotide.com/w/<id> opens the full IDE on the same backend as your desktop window: the same folder, editors, terminals, agents, chat, account and plan, live in both. There is nothing else to install or configure beyond Settings › Ingot Web.

Keep the desktop app running while you use the web window. Quitting it takes the project offline.

  • Fast reopen. The first time you open a project in a browser, it downloads the IDE once (about 7 MB, compressed). Opening it again in the same browser only checks for changes (a few hundred bytes), until you update Ingot. Release builds can also load the two largest files from the Ingot download servers, pinned to your exact version. This CDN is optional: if it can't be reached, the files come from your own computer instead.
  • Always the same version. The web window is built from the same release as your desktop app, so the two always match. If they ever don't, for example in a mixed development build, the web window says so instead of opening.
  • What looks different. The web window is the browser build of the same IDE, so desktop-only parts, such as the native menus and the system title bar, look like the browser version there. Extension web views don't work through the relay yet.

Configure a project: .ingot/web.json

Like an extension's manifest, a project can carry its Web settings in .ingot/web.json. Every field is optional.

{
  "name": "Shop",
  "defaultRole": "view",
  "previewPort": 5173,
  "allowedEmails": ["dana@example.com"],
  "shareExpiresDays": 7
}
FieldMeaning
nameThe project name on the dashboard and in links. Default: the folder name.
defaultRoleview (anyone with the share link reads the code and follows where you are editing) or edit (the share link is also an edit link: signed-in Ingot users with it can ask to edit; you approve each one).
previewPortA local port of your running app (1024 to 65535). The owner sees it at /w/<id>/__preview/. Leave it out to keep your app private.
allowedEmailsWho may ask to edit, with or without the link (you still approve each one). Up to 50 addresses.
shareExpiresDaysThe share link stops working after 1, 7, 30 or 90 days; 0 never expires.

.ingot/web.json itself is never shown to viewers.

Serve from a server or VM: ingot serve

On a machine without a desktop, run Ingot headless with the ingot CLI. It authenticates exactly like publishing an extension: with a publisher token.

  1. In the dashboard, open Publisher › Tokens and create a token with Serve Web projects (ingot serve) (scope web:serve). Add Publish Web projects (web:publish) if you also want ingot web publish. It is the same token page as for extensions; tokens expire and you can revoke them there.
  2. Get the headless Ingot package, ingot-server-<version>-linux-x64.tar.gz (also for linux-arm64 and mac-arm64), unpack it, and point --app (or INGOT_SERVE_APP) at the folder. Download it from Download › Headless Ingot; Headless Ingot is the full guide (env vars, systemd, security).
  3. Install the CLI with npm install -g @ingotide/cli. It needs Node.js 22.
  4. In the project folder:
export INGOT_WEB_TOKEN=ingot_pub_...
ingot serve . --port 3100 --name "Build box" --app /opt/ingot-server

Ingot listens on 127.0.0.1 only; the relay reaches it from the machine itself. ingot web publish reserves the project and prints its links without starting Ingot.

You can also start the package directly with bin/ingot-server [folder]; it listens on INGOT_PORT (default 3100). On macOS, if the download is quarantined, run xattr -dr com.apple.quarantine <folder> once.

FlagDefault
--port <port>3100 (local only)
--name <name>name in .ingot/web.json, then the folder name
--app <dir>INGOT_SERVE_APP
--token <token>INGOT_WEB_TOKEN, then INGOT_PUBLISH_TOKEN, then ingot login
--server <url>INGOT_SERVER_URL, then https://ingot-server.fly.dev

Keep it running with systemd

# /etc/systemd/system/ingot-web.service
[Unit]
Description=Ingot Web project (shop)
After=network-online.target

[Service]
User=dev
WorkingDirectory=/home/dev/shop
Environment=INGOT_WEB_TOKEN=ingot_pub_...
Environment=INGOT_SERVE_APP=/opt/ingot-server
ExecStart=/usr/bin/ingot serve /home/dev/shop --port 3100
Restart=on-failure

[Install]
WantedBy=multi-user.target

Then sudo systemctl enable --now ingot-web. Keep the token in a file only that user can read (EnvironmentFile=) rather than in the unit if others can read it.

Share a project

On the dashboard, Web projects lists every project with its link, status (online, offline or stopped), share role, who joined, when it was created and last active.

  • Open opens the full IDE (owner only).
  • Copy share link copies the view-only link. Viewers see the file tree, read files and follow the file and line you are editing, with your unsaved text. They never reach your terminal, agents, settings or anything outside the project folder, and they never see VCS internals, dependencies, build output or files that look like secrets (.env*, keys, *secret*, *credential*).
  • Rotate link makes a new share link: the old one, and every open web tab, stops working at once.
  • Stop works like Stop Sharing to Web on the desktop; Share again brings it back.
  • Delete removes the project and frees its slot.

When your computer is offline, the link shows offline with the time it was last active; it comes back as soon as Ingot runs there again.

On a phone, /remote keeps the compact remote UI. On a tablet or desktop browser it shows Open full editor for a computer that serves a Web project.

Let others edit (Ingot Together)

People can edit a Web project with you, from a browser, without ever reaching your terminals, agents or computer: they join an Ingot Together session that your Ingot hosts.

  1. In the desktop app, turn on Settings › Ingot Web › Let others edit (setting ingot.web.allowEditors, off by default; also in Settings › Features and the first-run setup).
  2. Put their emails in allowedEmails in .ingot/web.json, or set "defaultRole": "edit" so your share link becomes an edit link.
  3. They open ingotide.com/w/<id> signed in to Ingot (with the link, if you gave them one) and click Ask <your name> to edit.
  4. Your Ingot asks Allow once, Allow or Deny, with their name and email. Allow also remembers that person until you stop sharing or rotate the link.
  5. On Allow, Ingot starts an Ingot Together session for the project (or uses the one you are hosting; it turns Together on if needed) and they join it in the browser: they edit your current file live, use the session chat (@Ingot asks your Ingot) and the team channel. Images, reactions and the pencil work between Ingot desktop windows.
  • Who is editing. The Web item in the status bar lists them; People Editing on the Web… in its menu removes someone. The dashboard shows them with Remove too.
  • Cut everyone off. Stop Sharing to Web, Stop or Rotate link end every editor's access at once, and they leave your session.
  • Ending your session ends their access too.
  • Limits. The session follows the Ingot Together limits: up to 8 people with you. Editing never uses the editor's own Web projects; the project and its slot are yours.
  • With Let others edit off, requests are refused without asking you. When nobody has Ingot open on the computer (ingot serve with no window), nobody can approve, so requests are refused.

Asking to edit on the phone app's /remote isn't available yet: approve requests in Ingot on your computer or in its web window.

AI on your plan

Ingot Web is always served by your own machine, on every plan. What changes with the plan is AI:

  • Free: the editor, terminal, Git, extensions, search, Together (without @Ingot) and share links all work in the browser. AI features (agent chat, Tab, inline edit, review, the Rex hand-off and subagents) are off in the web window. Where AI would appear, the window says AI is part of Ingot plans · See plans, quietly, without popups.
  • Bronze, Silver, Gold and Platinum: AI works in the browser exactly as in the desktop app.

Change your plan and AI turns on in the same web window, without reloading: Ingot checks your plan again when you come back to the window (and every minute). The Ingot server checks the plan on every AI request too, so the browser can never use AI the plan doesn't include.

Limits and pricing

PlanWeb projects includedAI in Ingot Web
Ingot Free1Off
Ingot Bronze3On
Ingot Silver5On
Ingot Gold7On
Ingot Platinum5 per seat, pooled (to be confirmed)On

Each extra Web project is $2.50 a month on a paid plan, added to your plan's subscription. Free can't add extra projects: remove the one it has, or choose a plan. Publishing past your allowance never charges you: Ingot asks you to add an extra project (desktop message, CLI hint, dashboard button) or to delete one. You can remove extra projects on the dashboard from the next period, never below what you use.

Security

  • Owner only. Only the account that published a project can open it as the full IDE. Another Ingot user with the link gets the view-only viewer at most, or, if you let them edit, an Ingot Together session you approve: the relay never forwards editors to your computer, only the Together server, and their access is a signed grant tied to the current link that Stop, Rotate or Remove ends at once.
  • Short-lived access. The dashboard hands the browser a one-time link that is valid for 60 seconds; it becomes a cookie for that project's path only, for 12 hours, and Stop or Rotate ends it at once.
  • Rate limits on opening, publishing and share-link reads.
  • Revoke from the desktop (Stop Sharing to Web), the dashboard (Stop, Rotate, Delete) or by revoking the publisher token.
  • Privacy mode is respected: with it on, Ingot says plainly that code passes through the relay encrypted in transit and is not stored.

Troubleshooting

ProblemWhat to do
The link says offlineOpen Ingot on the computer (or start ingot serve) and sign in. The status bar shows Web: live when it is back.
"Only the owner can open this project"Sign in with the account that published it, or ask the owner for a share link.
"Web projects are all in use"Add an extra project on the dashboard (paid plans), or delete one you no longer need. On Free, see the plans for more projects.
"AI is part of Ingot plans" in the web windowYou're on Free: AI is off in the browser. Choose a plan and come back to the window; AI turns on without a reload.
ingotide.com/web says version mismatchUpdate Ingot on that machine from the download page.
ingot serve says the token has no web scopeCreate a token with web:serve under Publisher › Tokens.
The share link stopped workingIt expired or the owner rotated it. Ask for a new link.
The web window says the versions don't matchThe desktop app and its web window come from different builds. Update or reinstall Ingot from the download page.
Extensions with their own web views look empty on the webSome extension web views are not available through the relay yet; they work in the desktop window.