What is Coswarm?
A self-hosted platform on Docker Swarm. It gives your own servers what a hosted platform gives you: deploys with rollouts, domains with automatic HTTPS and a firewall, a database tool, logs and a marketplace of apps, in one web panel. Cosmo, its assistant, can explain what went wrong and propose fixes you approve.
What do I need to run it?
A Linux server with Docker installed, root access, a public IPv4 address and a domain you can point at it. The install script sets up Swarm and everything else. More servers join as Swarm nodes with the token the panel shows you.
Is it really free?
Yes. Self-hosting Coswarm costs nothing, with every feature and no limits on apps, nodes or users. If your organisation wants help with setup, architecture or support, write to us.
Do I have to use Cosmo?
No. Cosmo is off until an administrator turns it on and sets up a model provider, and the panel works fully without it. You can also let it read only, so it explains but never changes anything.
Which models does Cosmo work with?
OpenAI, Anthropic and OpenRouter with your own key, Ollama on your own hardware, or any OpenAI-compatible server such as vLLM, LM Studio or LiteLLM. A model has to pass a check that it can call tools before it is used. Keys are stored encrypted and never sent back to the browser.
What does Cosmo send to the model provider?
Your messages and what Cosmo reads to answer them. Passwords, tokens and keys are masked before anything leaves the server, and values you paste become placeholders the server fills in, so the model never sees them. With Ollama, nothing leaves your network.
Can Cosmo break something?
Every change it proposes waits for your approval of that exact plan, and is checked against your role’s permissions twice. It deliberately has no shell, no SQL, no file writes and no user management. Deletes need the name typed out, and areas under four-eyes approval stay with people.
Do I need to know Kubernetes, or even Swarm?
No. Coswarm uses Swarm underneath and shows it as apps, domains and projects. If you know Swarm, every service setting is there when you want it.
I already run services on Swarm. Can Coswarm take them over?
Yes. Swarm Sync finds services created outside Coswarm and adopts them as a record, without restarting anything.
Can I deploy by pushing to git?
Coswarm deploys images, not source code. Build in your CI and deploy with the app’s deploy token: the panel writes a GitHub Actions step for you.
How do I update Coswarm?
The panel tells you when a new version is out and shows its changelog. One click updates its services. Releases are named by date, like v2026.10.24.
Your servers are waiting.
One command, a minute or so, and the panel is on your domain. Free, and yours to keep.
curl -fsSL https://coswarm.dev/install.sh | bash