aptly - Debian repository management tool

go get


Andrey Smirnov Simon Aquino Ryan Uber Sylvain Baubeau Sebastien Badia Vincent Bernat Sebastien Binet Dmitrii Kashin Paul Krohn Chris Read Guilhem Lettron netrunner-sync-service Phil Frost Ivan Kurnosov Bryan J. Hong Andrea Bernardo Ciddio Alexander Guy Michael Koval Antonio Santos James Lu Sean Artem Yakimenko Szymon Sobik Zhang, Guodong

See all contributors



Aptly is a swiss army knife for Debian repository management.

Documentation is available at For support use mailing list aptly-discuss.

Aptly features: ("+" means planned features)

  • make mirrors of remote Debian/Ubuntu repositories, limiting by components/architectures
  • take snapshots of mirrors at any point in time, fixing state of repository at some moment of time
  • publish snapshot as Debian repository, ready to be consumed by apt
  • controlled update of one or more packages in snapshot from upstream mirror, tracking dependencies
  • merge two or more snapshots into one
  • filter repository by search query, pulling dependencies when required
  • publish self-made packages as Debian repositories
  • REST API for remote access
  • mirror repositories "as-is" (without resigning with user's key) (+)
  • support for yum repositories (+)

Current limitations:

  • translations are not supported yet


To install aptly on Debian/Ubuntu, add new repository to /etc/apt/sources.list:

deb squeeze main

And import key that is used to sign the release:

$ apt-key adv --keyserver --recv-keys E083A3782A194991

After that you can install aptly as any other software package:

$ apt-get update
$ apt-get install aptly

Don't worry about squeeze part in repo name: aptly package should work on Debian squeeze+, Ubuntu 10.0+. Package contains aptly binary, man page and bash completion.

If you would like to use nightly builds (unstable), please use following repository:

deb nightly main

Binary executables (depends almost only on libc) are available for download from Bintray.

If you have Go environment set up, you can build aptly from source by running (go 1.4+ required):

go get -u
mkdir -p $GOPATH/src/
git clone $GOPATH/src/
cd $GOPATH/src/
gom -production install
gom build -o $GOPATH/bin/aptly

Aptly is using gom to fix external dependencies, so regular go get should work as well, but might fail or produce different result (if external libraries got updated).

If you don't have Go installed (or older version), you can easily install Go using gvm.



  • Vagrant configuration by Zane Williamson, allowing to bring two virtual servers, one with aptly installed and another one set up to install packages from repository published by aptly


With configuration management systems:

CLI for aptly API: