Co-op Cloud

Co-op Cloud is our officially preferred approach to self-hosting.

🫣 Watch out!

You might find some rough edges at this time, we are very interested to support the smoothing of those!

What is Co-op Cloud?

From coopcloud.tech

Public interest infrastructure. An alternative to corporate clouds built by tech co-ops.

They provide a catalogue of recipes that you can run on your own server using docker.

Also check their FAQ page.

How do I use it?

Prerequsites

You need a server, a small VPS is fine for a typical group.

Setting up your server

We won't cover the basics of how to setup your server (add users, secure it, install docker, etc...).

If you'd like a starting point for that, check out karrot/karrot-ansible.

Next step is to follow the New Operators Tutorial from Co-op Cloud.

Once you've done that you'll have:

• abra installed on your local computer
• an internet-reachable machine running linux configured to use with abra
• a traefik proxy running
• your domain name with DNS records pointing to your server

You can then proceed to deploy your Karrot instance.

Steps

1. abra app new karrot
   • choose your server
   • choose a domain name that karrot will be deployed under: this is what we refer to as <domain>
2. abra app config <domain> see configuration options page
3. Set all the secrets, even the ones you don't want to use:
   • abra app secret list <domain> for listing all secrets
   • abra app secret insert <domain> <secret name> <version> "<secret value>" for inserting a secret
   • abra app secret generate <domain> <secret name> <version> for generating a secret
4. abra app deploy <domain>
5. Wait for a few minutes while karrot initializes and then you can start creating accounts!