Guide for self-hosting Karrot

There are many ways to deploy Karrot, the recommended approach is to use Co-op cloud, but the other methods are available if you know what you're doing!

We publish docker images that can be used different deployments methods - see Docker images for more information.

You can find our releases over at Releases.

Pick your preferred method of self-hosting

Co-op Cloud

Our recommended approach

This is the most complete setup.

Docker Compose

Intermediate

This is good for trying out Karrot, or if you want a want a base to start from

Without docker

Expert mode

You'll likely need some knowledge about deploying python and django apps

How do you host karrot.world?

Well, actually using none of those methods 😃 ... kind of a hybrid approach.

We have an ansible setup (see karrot/yuca) which is:

• Debian base OS
• PostgreSQL and Redis Debian packages run using systemd
• Podman to run the app/worker containers as systemd services
• systemd socket activation for the app container - passes socket file descriptor into podman container 😎
• our prebuilt frontend assets served up by nginx
• unix sockets for everything! (nginx -> backend, backend -> db, backend -> redis)
• acme.sh for TLS certificates