path: root/builds.sr.ht/private-repos.md

# Private repos in builds.sr.ht jobs

<div class="alert alert-danger">
  <strong>Warning!</strong> The list of commands run in a builds.sr.ht job, as
  well as their stdout and stderr, are visible to the public - even if the job
  uses a private repository. Take care not to leak any secrets this way.
</div>

builds.sr.ht can use private repos on git.sr.ht and elsewhere, but you have to
configure each job with an SSH key that has access to your account.

1. Generate an SSH key and [add it to your account](https://meta.sr.ht/keys)
1. Add a secret using the [secrets management page](https://builds.sr.ht/secrets)
1. Copy the secret's UUID into your build manifest's secrets list.
1. Update your sources list to use the SSH clone URL - not the https clone URL.

The resulting build manifest should look something like this:

```yaml
image: # ...
secrets:
- c043e12e-a297-4ece-b09c-bb5a99dc4094
sources:
- git@git.sr.ht:~yourname/your-private-repo
```