---
title: Tutorials
---

<p>
  <strong>Welcome to sr.ht!</strong> We have lots of helpful tutorials to
  introduce you to our platform and get you productive as soon as possible.
</p>
<style>
.tutorial:not(:last-child) {
  margin-bottom: 1rem;
}
</style>
<div class="event-list">
  <h3 id="setting-up-your-account-amp-first-git-repository">Setting up your account &amp; first git repository</h3>
  <p>
    This tutorial is recommended as the first stop for any new user.
  </p>
  <a href="set-up-account-and-git.md" class="btn btn-success">
    Get started here
    <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="tutorial">
  <h3 id="contributing-to-srht-projects">Contributing to projects on SourceHut</h3>
  <p>
    Looking to contribute to an existing project? Most projects on sr.ht accept
    contributions via email. Check out our interactive tutorial for
    git-send-email.
  </p>
  <a href="https://git-send-email.io" class="btn btn-default">
    Read more
    <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="tutorial">
  <h3 id="organizing-projects">Organizing your own projects</h3>
  <p>
    Ready to set up your own projects? Make sure to read this short introduction
    to understand how projects are organized on SourceHut.
  </p>
  <a href="organizing-projects.md" class="btn btn-default">
    Read more
    <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="tutorial">
  <h3 id="getting-started-with-buildssrht">Getting started with builds.sr.ht</h3>
  <p>
    Running your first few jobs on our continuous integration platform,
    builds.sr.ht.
  </p>
  <a href="getting-started-with-builds.md" class="btn btn-default">
    Read more
    <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="tutorial">
  <h3 id="git-rebase">Mastering git rebase</h3>
  <p>
    git-rebase is a crucial tool in the toolbelt of the productive git user.
    Our comprehensive reference demystifies it.
  </p>
  <a href="https://git-rebase.io" class="btn btn-default">
    Read more
    <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="tutorial">
  <h3>Accepting patches from a mailing list</h3>
  <p>
    Integrating patches from mailing lists into your own projects.
  </p>
  <a href="accepting-patches-from-lists.md" class="btn btn-default">
    Read more
    <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="tutorial">
  <h3>Using secrets on builds.sr.ht</h3>
  <p>
    How to securely use secret data in builds.sr.ht jobs.
  </p>
  <a href="using-secrets-in-builds.md" class="btn btn-default">
    Read more
    <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>
-->
<hr />
<div class="alert alert-primary">
  <strong>More tutorials are coming!</strong>
  Is there something in particular you want to see here? Mention it on
  <a href="https://lists.sr.ht/~sircmpwn/sr.ht-discuss">sr.ht-discuss</a>!
</div>