---
title: builds.sr.ht tutorials
---

<p>
  Ready to do more with builds.sr.ht? Here is a collection of useful tutorials
  for setting up various kinds of build automations.
</p>
<style>
.tutorial:not(:last-child) {
  margin-bottom: 1rem;
}
</style>
<div class="event-list">
  <div class="event" style="margin-left: -0.5rem; margin-right: -0.5rem;">
    <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-success">
      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>
<div class="tutorial">
  <h3>Using builds.sr.ht for GitHub CI</h3>
  <p>
    builds.sr.ht can be used to run CI for platforms outside of sourcehut -
    here's how.
  </p>
  <a href="github-integration.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>Handling secrets in your build manifests</h3>
  <p>
    You can add secrets like SSH keys to your builds to automate deployments
    and more.
  </p>
  <a href="using-build-secrets.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>
<h3 id="example-manifests">Example build manifests</h3>
<p>
  Here are a few example build manifests to quickly get you started. Got one of
  your own to add? Send a patch to
  <a href="https://lists.sr.ht/~sircmpwn/sr.ht-dev">sr.ht-dev</a> editing this
  page!
</p>
<ul>
  <li>
    <a href="https://git.sr.ht/~sircmpwn/drewdevault.com/tree/master/.build.yml">
      Deploying a Jekyll blog
    </a>
  </li>
  <li>
    <a href="https://git.sr.ht/~sircmpwn/sourcehut.org/tree/master/.build.yml">
      Deploying a Hugo site
    </a>
  </li>
  <li>
    <a href="https://git.sr.ht/~sircmpwn/git.sr.ht/tree/master/.builds/alpine.yml">
      Building Alpine Linux packages for a third-party repo
    </a>
  </li>
  <li>
    <a href="https://git.sr.ht/~sircmpwn/git.sr.ht/tree/master/.builds/archlinux.yml">
      Building Arch Linux packages for a third-party repo
    </a>
  </li>
  <li>
    <a href="https://git.sr.ht/~emersion/mrsh/tree/master/.builds">
      Testing a C project on 3 platforms
    </a>
  </li>
  <li>
    <a href="https://git.sr.ht/~xaffe/matrix-dokumentation/tree/master/.build.yml">
      Use a specific node version in your build with nvm
    </a>
  </li>
</ul>