Self-host

Prerequisites: Docker (running) and Node ≥ 22.

Start the daemon

git clone https://github.com/InsForge/insta-oss.git && cd insta-oss
npm install
npm run build:ui        # optional: the web dashboard, served by the daemon itself
npm run dev             # http://127.0.0.1:8080  (INSTA_OSS_PORT to change)

First run pulls postgres:16-alpine, dxflrs/garage, and rclone/rclone; give it a minute. State lives in ~/.insta-oss/.

Install the CLI and point it at the daemon

curl -fsSL https://agents.instacloud.com | sh          # CLI + agent skills (or: npm install -g insta)
export INSTA_API_URL=http://127.0.0.1:8080     # the CLI defaults to the cloud

No insta login: the daemon trusts localhost.

Get started

Concepts

Reference