---
name: "adt-build-lxc"
section: "1"
platform: "linux"
package: "autopkgtest"
version: "3.6jessie1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/adt-build-lxc"
---

# adt-build-lxc(1)

Create or update autopkgtest container for adt-virt-lxc

## NAME

adt-build-lxc - Create or update autopkgtest container for adt-virt-lxc

## SYNOPSYS

**adt-build-lxc** *distribution release* \[*architecture*\]

## DESCRIPTION

**adt-build-lxc** creates or updates an LXC container **adt-***release* which is suitable for autopkgtest's LXC runner [**adt-virt-lxc**(1)](/adt-virt-lxc/1.md).

It calls **lxc-create** with the *distribution* template (which can currently be **debian** or **ubuntu) and** **-r***release* to build a debootstrap-like container, then enables **deb-src** apt sources, and runs **apt-get update.**

It defaults to the native architecture, but you can specify a different one as third parameter.

If the container already exists, it updates it as unintrusively as possible by first creating a new temporary container **adt-***release***.new**, and then rsyncing its root file system back to the existing **adt-***release*. Note that this could cause some side-effects and breakage if you have running containers with ephemeral overlays (i. e. using the **--ephemeral** option), but it does work in general. This update process does not interfere at all if you use **adt-virt-lxc** with cloning.

Note that you need to call this as root, unless you set up LXC to allow per-user containers. But user containers will not work with many or even most autopkgtests.

You can specify an apt proxy to use in the container in the **$ADT\_APT\_PROXY** environment variable. If apt-cacher-ng is running on the local host, the container will automatically use this (i. e. use the IP from the **lxcbr0** interface) otherwise there is no default.

## EXAMPLES

\# adt-build-lxc debian sid

$ sudo adt-build-lxc ubuntu trusty i386

## SEE ALSO

[**adt-virt-lxc**(1)](/adt-virt-lxc/1.md), [**adt-run**(1)](/adt-run/1.md), [**lxc-create**(1)](/lxc-create/1.md), **/usr/share/doc/autopkgtest/**.

## AUTHORS AND COPYRIGHT

**adt-build-lxc** was written by Martin Pitt \<martin.pitt@ubuntu.com\>

This manpage is part of autopkgtest, a tool for testing Debian binary packages.  autopkgtest is Copyright (C) 2006-2014 Canonical Ltd and others.

See **/usr/share/doc/autopkgtest/CREDITS** for the list of contributors and full copying conditions.