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 GitHub

What 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.

From this repository
Web appThe editor, sign-in and the APIpnpm start · port 3000
WorkerRuns queued workflows and fires schedulespnpm worker
MCP serverLets your AI apps use your workflowspnpm mcp:http · port 3001
You provide
Postgres 15 or laterWorkflows, runs, records and search
Redis 7The run queue, and live updates between open editors

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.

Terminal
$ 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.

Invites need a mail providerTutti emails each invite and a link to confirm each later account, so set 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.

.env
# 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
DATABASE_URLPostgres. The one Compose starts has a fixed password and listens on this machine only, so give a server your own.
REDIS_URLQueues runs for the worker and keeps open editors in step.
BETTER_AUTH_SECRETSigns sign-in sessions. Changing it signs everyone out.
INTEGRATION_ENCRYPTION_KEYEncrypts saved connections. Keep it safe: without it they can't be read.
BETTER_AUTH_URL · NEXT_PUBLIC_APP_URLThe address people open. Next.js fixes NEXT_PUBLIC_ values into the build, so run pnpm build again after changing one.
NEXT_PUBLIC_MCP_SERVER_URLYour MCP server's address, shown in Settings › AI apps. The MCP server finds the app through WORKFLOW_API_URL, which is http://localhost:3000 unless you set it.

Optional settings

Add what you need to .env. Everything else in .env.example can stay out.

AI steps and AskAI_GATEWAY_API_KEY or ANTHROPIC_API_KEY
EmailRESEND_SYSTEM_API_KEY, RESEND_SYSTEM_FROM_EMAIL: confirmations, password resets and invites
Sign in with GoogleGOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET
Gmail, Drive, SlackYour own OAuth apps: SYSTEM_GOOGLE_*, SLACK_CLIENT_*
The workerWORKER_CONCURRENCY 20, EXECUTION_TIMEOUT_MS 300000, MAX_RETRIES 3
Your own networkAGENTS_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.
Every variable →

Deploy it somewhere else

Upgrade

Back up firstAn upgrade can change your tables. Take a Postgres backup before you start.
Terminal
$ 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