Self-host the app
Run the whole of Tutti on your own servers: the web app, a worker that runs workflows in the background, and an MCP server for your AI apps. You bring Postgres and Redis.
Edit this page on GitHubWhat you run
Three processes from this repository, and two services you provide. AI apps reach Tutti through the MCP server; the app and the worker share Postgres and Redis.
Run it from source
You need Node 24, pnpm 9 and Docker. Docker only starts Postgres and Redis: the app, the worker and the MCP server run from the checkout.
$ git clone https://github.com/Darkmatter-AI/tutti.git$ cd tutti$ pnpm install# save the required settings below as .env, then$ docker compose up -d postgres redis$ pnpm db:push # creates the tables in an empty database$ pnpm build && pnpm start# in a second terminal$ pnpm worker# in a third, for AI apps$ pnpm mcp:http
When it is up, open http://localhost:3000.
The first account
Open the app and sign up. The first account owns the workspace, and it needs no email to confirm it. After that, sign-up is by invite only: invite everyone else from Settings › Members.
Onboarding then offers to write your first workflow. That needs an AI key from the optional settings, so without one skip it and use New workflow.
RESEND_SYSTEM_API_KEY and RESEND_SYSTEM_FROM_EMAIL before you invite anyone.Required settings
Seven settings, read from .env. These work as they are on one machine, once you make each secret with openssl rand -hex 32.
# The Postgres and Redis that docker compose startsDATABASE_URL=postgres://postgres:postgres@localhost:5432/workflow_devREDIS_URL=redis://localhost:6379# Secrets: openssl rand -hex 32, one eachBETTER_AUTH_SECRET=INTEGRATION_ENCRYPTION_KEY=# The addresses people and AI apps useBETTER_AUTH_URL=http://localhost:3000NEXT_PUBLIC_APP_URL=http://localhost:3000NEXT_PUBLIC_MCP_SERVER_URL=http://localhost:3001
pnpm build again after changing one.Optional settings
Add what you need to .env. Everything else in .env.example can stay out.
AI_GATEWAY_API_KEY or ANTHROPIC_API_KEYRESEND_SYSTEM_API_KEY, RESEND_SYSTEM_FROM_EMAIL: confirmations, password resets and invitesGOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRETSYSTEM_GOOGLE_*, SLACK_CLIENT_*WORKER_CONCURRENCY 20, EXECUTION_TIMEOUT_MS 300000, MAX_RETRIES 3AGENTS_LOCAL_ALLOW_PRIVATE_IPS set to 1 lets database, HTTP and file-reading steps reach private addresses. Without it they refuse them, so leave it off if people you don't trust can build workflows.Deploy it somewhere else
Upgrade
$ git checkout lib/integrations/platform-urls.ts # the build rewrites this file$ git pull$ pnpm install$ pnpm db:push # brings the tables up to the new schema$ pnpm build # then restart the app, the worker and the MCP server