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 0b2cece8723735483503b97574b18741d0710998
Author: fardog <nat@fardog.io>
Date:   2026-01-07T20:47:09Z

terms: fix language around content deletion

This supersedes [#66048][], as I named the incorrect project name in the
subject, which caused the build to fail. Original email is quoted below:

[#66048]: https://lists.sr.ht/~sircmpwn/sr.ht-dev/patches/66048

A very small typo I noted in the terms of service; alternatively it
could be corrected as "will not [be] displayed", but either one reads
fine to me. No worries if the terms need more ceremony to be changed;
was as easy to submit as a patch as it would've been to raise in the
mailing list.
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)