Skip to content

Install

You have three ways to run Restura. Pick the one that fits.

Web — restura.dev

Nothing to install. Open the link, accept the default settings, and you’re sending requests. Data stays in your browser (IndexedDB).

Desktop — macOS / Windows / Linux

Full native capability: mTLS, SOCKS, custom CAs, Kafka, MQTT, the AI assistant + AI Lab, OS keychain. Built with Electron.

Self-hosted — Docker

Single image, one port. Drop it behind your reverse proxy, set an auth token, done. Stateless server, browser-local storage.

Open restura.dev. That’s it.

All your data — collections, environments, history, secrets — is stored in your browser via IndexedDB. Clearing site data clears Restura.

Some protocols and features need native networking and are desktop only. The web UI shows a “Desktop only” badge on those fields. See the capability matrix for the full list.

Download from the GitHub releases page or build from source.

  • Download the .dmg (Intel or Apple Silicon) from the latest release.
  • Drag Restura.app to /Applications.
  • Stable releases are signed and notarized. If macOS still blocks a download, verify you installed the release asset from Restura’s GitHub releases page before approving it in System Settings.

Desktop builds unlock the full feature set — see Platforms for the differences. Once installed, the app keeps itself up to date automatically — see Desktop updates.

A single image serves the SPA and the API proxy on one port.

Terminal window
docker run -p 3000:3000 \
-e WORKER_PROXY_TOKEN=$(openssl rand -hex 32) \
ghcr.io/dipjyotimetia/restura:latest

The server is stateless — all collections, environments, and history live in the browser’s IndexedDB, exactly like the web app. Your data does not leave the browser.

For production setups (reverse proxy, TLS, multi-replica), see Self-hosting → Docker and Reverse proxy.

Only download from the GitHub releases page, ghcr.io/dipjyotimetia/restura, npm or restura.dev. Every release is built with signed provenance you can check with the GitHub CLI:

Terminal window
# Desktop installer (.dmg, .exe, .AppImage, .deb, .rpm)
gh attestation verify <downloaded-file> --repo dipjyotimetia/restura
# Docker image (pin by digest in production)
gh attestation verify oci://ghcr.io/dipjyotimetia/restura:<version> --repo dipjyotimetia/restura
# CLI, inside a project that depends on restura-cli
npm audit signatures

On macOS, spctl --assess --type execute --verbose /Applications/Restura.app should report source=Notarized Developer ID. Windows installers are not code-signed yet, so rely on the attestation check. Each release also attaches a CycloneDX SBOM (restura.cdx.json) for checking CVE exposure.

The full guide, including the SBOM and extension steps, is in SECURITY.md.