Bonfire/Set up/Self-hosting

You run it

Host Bonfire yourself.

Bonfire is open source and AGPL, free forever. You can run it on your own infrastructure. Your data, your policies, no fees. It's a first-class route, and it's the right one for communities with the technical capacity (or the appetite to build it). Here's what that involves, and where to turn if you'd rather not.

What you get
  • Full control, on infrastructure you choose
  • Your data, your moderation, your code of conduct
  • No fees, no ads. Open source, free forever
  • Full federation with the open social web
  • Pick a flavour, or build your own from the extensions you need
What it takes
  • A server (or virtual machine) you look after (≈8 GB+ RAM depending on how many active users) and SSH access
  • Comfort at the command line
  • Updates, backups and security are your responsibility
  • When a member needs help, you're tech support
  • Put aside a few hours for initial set up, and ongoing care after

Not very technical? You needn't do it alone, we can help you set it up. Or skip the ops entirely: two other routes hand the running over to a hosting co-op.

The shape of it

Five steps to get up and running.

A bird's-eye view so you can gauge the effort. Every step is covered in detail in the setup guide, but here's an overview.

  1. 1

    Get a server you control

    A machine you can SSH into, with about 8 GB+ of RAM. Best of all is your own hardware, or a virtual machine on infrastructure run by friends, allies, or a co-op you trust, keeping it close to home. A rented VPS or dedicated server (Hetzner is a common choice) works as well. Wherever it runs, you hold the keys.

  2. 2

    Set up a domain, email & DNS

    Pick a domain or subdomain, it becomes part of every username, like @you@yourdomain.net. Add an email service (Mailgun, SMTP, or similar) for sign-ups and notifications, and set up DNS records.

  3. 3

    Choose how to run it

    Bonfire can be deployed a few ways, from most hands-off to most hands-on. Pick the one that fits your setup:

    Co-op Cloud · recommended

    Tooling built by tech co-ops, with a ready-made Bonfire recipe. Easiest path, and handy if you'll host other open source apps too.

    Docker

    Pull our pre-built images (easy mode), or build your own if you want to assemble your own flavour from available extensions.

    Bare-metal

    No containers: you run Postgres, Elixir and a process supervisor yourself. Most control, most manual work.

    Guix

    Declarative and reproducible, via the bonfire-guix channel, for the infrastructure-as-code crowd.

  4. 4

    Pick a flavour & configure

    Choose the flavour that fits: community, social, and others each ship a different set of features. Then fill in a .env with your domain, mail keys, etc.

  5. 5

    Launch & sign up

    Bring it up behind HTTPS and open your domain. Instances are invite-only by default, the first account to sign up skips that and becomes the admin, so you're in control from the first minute.

You're not on your own

Self-hosting doesn't mean going it alone.

Free

Community support

Ask for advice in the chat, the easiest door when you hit a snag.

Join us on Matrix →
Guided

Set it up together

New to servers? We occasionally run community install parties as well as 1-on-1 sessions for clients, to walk you through setup, screen to screen, then hand you the keys.

Get in touch →
Hand it off

Cooperative hosting

Decide the ops aren't for you after all? A co-op can run the whole thing, so you can have your own space without the sysadmin job.

Cooperative hosting →

Self-hosting not for you?

Three ways in, pick another.

You run it · you're here

Install Bonfire on your own

For those who want to self-host their own Bonfire instance. You'll need to be comfortable with the command line.

  • Full control, on your own infrastructure
  • AGPL, free forever
  • Docker-based deployment
◼ good if: you have a server & some sysadmin comfort

New to servers? We run guided install parties & 1-on-1 setup.

We run it together

Cooperative hosting

Join a nascent co-operative ecosystem to operate a sustainable, resilient infrastructure for Bonfire development, hosting, and support.

  • No servers to look after
  • Updates & backups handled
  • Co-op infrastructure, not a corporate cloud
◼ good if: you want your space, not a sysadmin job
We build it with you

Go further with Mosaic

Rely on the Bonfire team to build a tailored digital space for your community and support you through the whole process.

  • Co-design workshops with your people
  • Your identity, governance & integrations
  • Training, ongoing care & co-op hosting
◼ good if: your community needs a space shaped around it