---
title: sourcehut docs
toc: false
---

<p>
  <strong>Welcome to sourcehut!</strong> You can access each of your services
  from the links in the navigation at the top of the site. You're currently on
  man.sr.ht, which provides the user manual and hosts wikis for your projects.
</p>
<style>
dt {
  font-weight: normal;
}
</style>
<div class="event-row event-list">
  <div class="col-xs-12 col-md-6 event">
    <h3 id="start-here">Start here!</h3>
    <p>
      New here? We have some great tutorials to get you started.
    </p>
    <a href="tutorials" class="btn btn-primary btn-block">
      Read the tutorials
      <span class="icon icon-caret-right">
        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 192 512"><path d="M0 384.662V127.338c0-17.818 21.543-26.741 34.142-14.142l128.662 128.662c7.81 7.81 7.81 20.474 0 28.284L34.142 398.804C21.543 411.404 0 402.48 0 384.662z"/></svg>
      </span>
    </a>
  </div>
  <div class="col-xs-12 col-md-6 event">
    <h3 id="general-documentation">General documentation</h3>
    <p>
      Information on billing, terms of service, privacy policy, and so on.
    </p>
    <a href="sr.ht" class="btn btn-default btn-block">
      Read boring stuff
      <span class="icon icon-caret-right">
        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 192 512"><path d="M0 384.662V127.338c0-17.818 21.543-26.741 34.142-14.142l128.662 128.662c7.81 7.81 7.81 20.474 0 28.284L34.142 398.804C21.543 411.404 0 402.48 0 384.662z"/></svg>
      </span>
    </a>
  </div>
  <div class="col-xs-12 col-md-6 event">
    <h3 id="getting-help">Getting help</h3>
    <p>
      Need support? There are several resources available to you.
    </p>
    <a href="support.md" class="btn btn-default btn-block">
      Support resources
      <span class="icon icon-caret-right">
        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 192 512"><path d="M0 384.662V127.338c0-17.818 21.543-26.741 34.142-14.142l128.662 128.662c7.81 7.81 7.81 20.474 0 28.284L34.142 398.804C21.543 411.404 0 402.48 0 384.662z"/></svg>
      </span>
    </a>
  </div>
  <div class="col-xs-12 col-md-6 event">
    <h3 id="developers-amp-admins">Developers &amp; admins</h3>
    <p>
      Hacking on or deploying sourcehut yourself? Resources here.
    </p>
    <a href="installation.md" class="btn btn-default btn-block">
      Getting started
      <span class="icon icon-caret-right">
        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 192 512"><path d="M0 384.662V127.338c0-17.818 21.543-26.741 34.142-14.142l128.662 128.662c7.81 7.81 7.81 20.474 0 28.284L34.142 398.804C21.543 411.404 0 402.48 0 384.662z"/></svg>
      </span>
    </a>
  </div>
</div>
<div class="alert alert-warning">
  <strong>Notice</strong>: sr.ht documentation is a work in progress, and is
  incomplete in many places.
</div>
<h3 id="news-and-updates">News &amp; Updates</h3>
<p>
  Want to keep up with the latest news on sr.ht? A monthly "what's cooking" is
  posted to the
  <a href="https://lists.sr.ht/~sircmpwn/sr.ht-announce"
  >sr.ht-announce</a> list. Consider subscribing!
</p>
<h3 id="service-documentation">Service Documentation</h3>
<dl class="row">
  <div class="col-md-4">
    <dt>
      <strong>Project hub</strong>
    </dt>
    <dd>
      <a href="/hub.sr.ht">User Manual</a>
      &mdash;
      <a href="/hub.sr.ht/api.md">API Reference</a>
    </dd>
  </div>
  <div class="col-md-4">
    <dt>
      <strong>git.sr.ht</strong>: git hosting
    </dt>
    <dd>
      <a href="/git.sr.ht">User Manual</a>
      &mdash;
      <a href="/git.sr.ht/graphql.md">API Reference</a>
    </dd>
  </div>
  <div class="col-md-4">
    <dt>
      <strong>hg.sr.ht</strong>*: mercurial hosting
    </dt>
    <dd>
      <a href="/hg.sr.ht">User Manual</a>
      &mdash;
      <a href="/hg.sr.ht/graphql.md">API Reference</a>
    </dd>
  </div>
  <div class="col-md-4">
    <dt>
      <strong>builds.sr.ht</strong>: build service
    </dt>
    <dd>
      <a href="/builds.sr.ht">User Manual</a>
      &mdash;
      <a href="/builds.sr.ht/api.md">API Reference</a>
    </dd>
  </div>
  <div class="col-md-4">
    <dt>
      <strong>todo.sr.ht</strong>: bug tracking
    </dt>
    <dd>
      <a href="/todo.sr.ht">User Manual</a>
      &mdash;
      <a href="/todo.sr.ht/graphql.md">API Reference</a>
    </dd>
  </div>
  <div class="col-md-4">
    <dt>
      <strong>lists.sr.ht</strong>: mailing lists
    </dt>
    <dd>
      <a href="/lists.sr.ht">User Manual</a>
      &mdash;
      <a href="/lists.sr.ht/api.md">API Reference</a>
    </dd>
  </div>
  <div class="col-md-4">
    <dt>
      <strong>chat.sr.ht</strong>: IRC chat rooms
    </dt>
    <dd>
      <a href="/chat.sr.ht">User Manual</a>
    </dd>
  </div>
  <div class="col-md-4">
    <dt>
      <strong>man.sr.ht</strong>: manual &amp; wikis
    </dt>
    <dd>
      <a href="/man.sr.ht">User Manual</a>
    </dd>
  </div>
  <div class="col-md-4">
    <dt>
      <strong>meta.sr.ht</strong>: account &amp; security
    </dt>
    <dd>
      <a href="/meta.sr.ht">User Manual</a>
      &mdash;
      <a href="/meta.sr.ht/graphql.md">API Reference</a>
    </dd>
  </div>
</dl>
<h3 id="secondary-services">Secondary services</h3>
<p>
  The services shown above are the primary services offered by sr.ht. Some
  secondary services are also available.
</p>
<dl class="row">
  <div class="col-md-4">
    <dt>
      <strong>paste.sr.ht</strong>: ad-hoc text file hosting
    </dt>
    <dd>
      <a href="/paste.sr.ht">User Manual</a>
      &mdash;
      <a href="/paste.sr.ht/api.md">API Reference</a>
    </dd>
  </div>
  <div class="col-md-4">
    <dt>
      <strong>pages.sr.ht</strong>: static web hosting
    </dt>
    <dd>
      <a href="https://srht.site">User Manual</a>
      &mdash;
      <a href="/pages.sr.ht/installation.md">Installation</a>
    </dd>
  </div>
</dl>
<p>
* These services are maintained by sourcehut community members, on
  infrastructure provided by sourcehut.
</p>