Getting Started


Currently there are stages available for the following platforms:


These are stages targeting fairly new targets, or ones that do not have a lot of users.

Users should be able to fix issues on these targets intelligently before complaining of issues.

Stage Requirements

Easiest solution: SystemRescueCD

Install Guide

Installing Exherbo

Managing packages

Paludis documentation

Source code

It is possible to get all of our shiny stuff via anonymous git.

You can browse our repositories via cgit.

Contributing your first patch

Step 1

If you don’t already have Git set up:

git config --global "<your real name>"
git config --global "<your email>"

Step 2

Register an account on Gerrit. You need a GitHub or Google account. The email address you wish to use in Gerrit must be configured in your GitHub account.

Step 3

Clone the repository you want to change things in from Gerrit and set up the Change-Id hook. See ‘Cloning repositories’.

Step 4

Set up cave to sync from this local clone.

Edit /etc/paludis/repositories/<repo>.conf and change the line:

sync = git+<repo>.git


sync = git+<repo>.git local: git+file:///home/<user>/<path to local repo>

Then, you can sync from the local clone with cave sync -s local <repo>. For more info on this see our workflow docs.

Step 5

Make your changes in the local clone and commit the changes to the repository. Remember to actually commit the changes; otherwise, cave will not see them since it is using git pull to pull from the local clone. For more info on using Git see the Git book.

Step 6

Testing out your changes:

cave sync -s local <repo>
cave resolve -x1 <package modified>

If they are not to your liking, go back to step 5, using git commit --amend and git rebase -i as much as you want.

Step 7

Submit your changes to Gerrit.

git push origin HEAD:refs/for/master