# Environment

## Build environment creation

The following steps needs to be run just once for each arch and distro version.

### Setup cowbuilder chroots

This is the recommended method:

    sudo mkdir -p /var/cache/pbuilder/sid-amd64
    sudo -E cowbuilder --create

    sudo mkdir -p /var/cache/pbuilder/stretch-amd64
    sudo -E DIST=bookworm cowbuilder --create

### Setup pbuilder chroots

If you want to setup directly using `pbuilder`:

    git-pbuilder create
    DIST=bookworm git-pbuilder

### Compatibility with git-buildpackage

This is a workaround while we don't find a cleaner way to fix
[this issue](http://ramblingfoo.blogspot.com.br/2012/10/howto-sudo-cowbuilder-git-buildpackage.html)
with `git-buildpackage` not getting `~/.pbuilderrc` from the local user:

    ( cd /var/cache/pbuilder/ && sudo ln -s sid-amd64/base.cow )

## External repository integration

If your package storage lives elsewhere, make a symlink like this:

    (
      mkdir /var/data/distros/debian/packages/build-area/bookworm-amd64
      cd /var/cache/pbuilder/bookworm-amd64 && \
      sudo rm -rf result                    && \
      sudo ln -s /var/data/distros/debian/packages/build-area/bookworm-amd64 result
    )

## Environment maintenance

These steps should be run once in a while to ensure we have an up to date packaging environment.

### Pbuilder

    DIST=sid      git-pbuilder update
    DIST=bookworm git-pbuilder update --override-config

### Cowbuilder

    DIST=sid      sudo -E cowbuilder --update
    DIST=bookworm sudo -E cowbuilder --update --override-config