Skip to main content

Self-hosting

Youkore is desktop-first, but the gateway is a normal Python process and runs fine on a Linux/Windows server. The Flutter client connects over HTTP/WebSocket from another machine on your local network or tailnet.

This page is a sketch — full instructions land when the Linux build pipeline does.

What you need​

  • Python 3.12 (the gateway is Nuitka-compiled in production, but development runs straight from source)
  • A directory you control for ~/.youkore/
  • Optional: a Tailscale tailnet so the Flutter client can reach the gateway from a phone or another laptop without exposing ports

Run from source​

git clone <repo>
cd youkore
python -m venv .venv
. .venv/bin/activate          # or .venv\Scripts\activate on Windows
pip install -r requirements/base.txt
python start.py

start.py boots the gateway on localhost:18789 and the microservices subprocess on localhost:8100.

Connect a remote client​

In the Flutter client's onboarding screen, point it at the gateway's address:

http://<server>:18789

If you're on Tailscale, the address is the gateway's tailnet name. If you're on a LAN, it's the local IP. Don't expose port 18789 directly to the public internet — the gateway expects a trusted network.

Persist data​

Everything user-related lives under ~/.youkore/:

  • agents/ — agent definitions
  • plugins/ — installed plugins
  • chroma/ — vector memory
  • gateway.json — this gateway's stable UUID

Back up that directory, you back up everything.

Updates​

The same releases-worker that auto-updates desktop installs serves Linux when those builds exist. Until then, git pull && pip install -r requirements/base.txt is the path.