Deloc documentation

Deloc turns anything you build on your machine into a shareable URL. This guide covers the CLI, the MCP server for AI coding tools, every deploy option, server-side Actions, and scheduled data refresh pipelines from BigQuery and other warehouses.

What is Deloc

You build something locally — a dashboard, a prototype, a one-pager. You want to show it to a teammate without spinning up infrastructure, buying a domain, or configuring a build pipeline. Deloc publishes it to a URL in one command.

Every project with an index.html can ship. You do not need a framework, a package.json, or a build system. The free tier gives you three live apps, 100MB storage, 1GB of bandwidth per app per month, and 30-day auto-expiry you can renew.

60-second quickstart

From any project folder:

shell
npx @deloc/cli deploy

The CLI auto-detects your framework (Vite, Next, Create React App, static HTML, and more), runs your build command if it needs to, zips the output, uploads it, and prints a live URL. First time? A browser opens for a Google or Microsoft sign-in.

Re-deploying preserves the URL
Run deloc deploy again from the same directory and the app updates in place. The URL, password, and settings stay the same. To publish a second app, pass --name.

CLI or MCP: which to use

The CLI and the MCP server expose the same capabilities. Pick by workflow:

  • CLI — use from a terminal, a CI pipeline, a shell script, or a build hook. Install once with npm i -g @deloc/cli or call ad-hoc with npx @deloc/cli <cmd>.
  • MCP server — use from inside Claude Code, Cursor, Windsurf, or Codex. Say "deploy this to Deloc" and the agent calls the tool. One-line install with deloc install-mcp.

Both use the same auth token in ~/.deloc/config.json, so logging in via either method works for both. Hit ⌘ K (or Ctrl K) any time in these docs to search.

Where to go next

CLI reference →
Every command and flag, grouped by purpose.
MCP server →
Claude Code, Cursor, Windsurf, and Codex setup.
Deploying →
Framework detection, flags, visibility, OG images.
Managing apps →
List, disable, delete, renew, password-protect.
Actions →
Call any HTTPS API from your static site with secrets.
Data & refresh →
Upload files, schedule BigQuery refreshes via Cloud Run.
SCIM provisioning →
Auto-provision and deprovision users from Okta or Entra.
Account & tokens →
API tokens, tier limits, billing.