What moves, and in what order
A migration off Open WebUI moves three things: the models you connect, the configuration that shapes the assistant, and the work people hand to it. Move them in that order so each step can be tested on its own.
- Bring the models first. Open WebUI points at Ollama or an OpenAI-compatible API, and Kortix accepts any model provider with your own keys, the ChatGPT plan you already pay for, or an OpenCode Console account (Read the docs). Connect your provider in the app and confirm a session can reach it.
- Turn the configuration into files. Open WebUI keeps its settings and environment variables in the running instance. Kortix keeps them in a git repo: agents are
agents/<name>.md, andkortix.yamldeclares the machine image, connectors and triggers, and the secret names and grants. - Define the agents and their reach. Each agent is a markdown file plus an
agents.<name>block inkortix.yaml, and its connectors decide which tools it may touch. Set each tool to Allow, Ask or Block down to the arguments of each call. - Connect where people work. Kortix is reachable from the web, desktop and mobile apps, the CLI and TUI, and Slack and Microsoft Teams. A trigger can also start a session on a cron schedule or a signed webhook, with no person present.
- Run one job and review it. Start a session, let the agent work on its own isolated sandbox and branch, and read the change request it opens before anything merges.
What does not move
Some things are Open WebUI features rather than data, so they have no file to copy across: its plugin and pipeline setup, and its community prompt presets. Rebuild the handful you actually use as agent skills or connectors in the repo, and leave the rest behind.
Start with one project, then let the repo grow
A project is a git repo with a kortix.yaml at its root, and Kortix hosts it or connects to the one you have. Create one, run one real job end to end, and let the repo grow from there (Read the docs). Run it on Kortix Cloud, in your VPC, or on-prem, with self-host free. Self-hosting Kortix is the operator path if the migration ends on your own box.