This document covers the installation steps for meta.sr.ht, the central authentication and account management service for SourceHut.

Notice: A working meta.sr.ht installation is a basic requirement of running any other sr.ht service.

Installation

Installation

Familiarize yourself with the general installation documentation before getting started.

Daemons

The following daemons are available in the meta.sr.ht package:

  • meta.sr.ht — The web service.
  • meta.sr.ht-api — The API service.

Enable and start them like so:

# service meta.sr.ht start
# service meta.sr.ht-api start
# rc-update add meta.sr.ht
# rc-update add meta.sr.ht-api

Cronjobs

Install a cronjob to run meta.sr.ht-daily as the meta user daily. For example:

0 * * * * chronic meta.sr.ht-daily

Note that if billing is enabled, this cronjob, among other tasks, will charge accounts due for payment.

Billing

To enable the billing system, install the separate meta.sr.ht-billing package and fill in the meta.sr.ht::billing section of config.ini. You need a working Stripe account to collect payments.

Users

To create users, use meta.sr.ht-manageuser. For example, to create an administrator:

meta.sr.ht-manageuser -t admin -e <email> <username>

About this wiki

commit 0688b192173baea25e97f0cb155d133f51d85a20
Author: CismonX <admin@cismon.net>
Date:   2026-02-21T18:03:46+08:00

builds.sr.ht: clarify FreeBSD image names

Rename FreeBSD images to the exact release names used upstream,
for better clarity.
Clone this wiki ("master" branch)
https://git.sr.ht/~sircmpwn/sr.ht-docs (read-only)
git@git.sr.ht:~sircmpwn/sr.ht-docs (read/write)