SYNOPSIS

Common command format:

aptly [global options\|.\|.\|.] command subcommand [options\|.\|.\|.] arguments

aptly has integrated help that matches contents of this manual page, to get help, prepend help to command name:

aptly help mirror create

DESCRIPTION

aptly is a tool to create partial and full mirrors of remote repositories, manage local repositories, filter them, merge, upgrade individual packages, take snapshots and publish them back as Debian repositories.

aptly\(cqs goal is to establish repeatability and controlled changes in a package-centric environment. aptly allows one to fix a set of packages in a repository, so that package installation and upgrade becomes deterministic. At the same time aptly allows one to perform controlled, fine-grained changes in repository contents to transition your package environment to new version.

CONFIGURATION

aptly looks for configuration file first in ~/.aptly.conf then in /etc/aptly.conf and, if no config file found, new one is created in home directory. If -config= flag is specified, aptly would use config file at specified location. Also aptly needs root directory for database, package and published repository storage. If not specified, directory defaults to ~/.aptly, it will be created if missing.

Configuration file is stored in JSON format (default values shown below):

  • {
      "rootDir": "$HOME/.aptly",
      "downloadConcurrency": 4,
      "downloadSpeedLimit": 0,
      "architectures": [],
      "dependencyFollowSuggests": false,
      "dependencyFollowRecommends": false
      "dependencyFollowAllVariants": false,
      "dependencyFollowSource": false,
      "gpgDisableSign": false,
      "gpgDisableVerify": false,
      "downloadSourcePackages": false,
      "ppaDistributorID": "ubuntu",
      "ppaCodename": "",
      "S3PublishEndpoints": {
        "test": {
          "region": "us-east-1",
          "bucket": "repo",
          "awsAccessKeyID": ""
          "awsSecretAccessKey": "",
          "prefix": "",
          "acl": "public-read",
          "storageClass": "",
          "encryptionMethod": "",
          "plusWorkaround": false
        }
    }
    

Options:

rootDir

is root of directory storage to store database (rootDir/db), downloaded packages (rootDir/pool) and published repositories (rootDir/public)

downloadConcurrency

is a number of parallel download threads to use when downloading packages

downloadSpeedLimit

limit in kbytes/sec on download speed while mirroring remote repositieis

architectures

is a list of architectures to process; if left empty defaults to all available architectures; could be overridden with option -architectures

dependencyFollowSuggests

follow contents of Suggests: field when processing dependencies for the package

dependencyFollowRecommends

follow contents of Recommends: field when processing dependencies for the package

dependencyFollowAllVariants

when dependency looks like package-a | package-b, follow both variants always

dependencyFollowSource

follow dependency from binary package to source package

gpgDisableSign

don\(cqt sign published repositories with gpg(1), also can be disabled on per-repo basis using -skip-signing flag when publishing

gpgDisableVerify

don\(cqt verify remote mirrors with gpg(1), also can be disabled on per-mirror basis using -ignore-signatures flag when creating and updating mirrors

downloadSourcePackages

if enabled, all mirrors created would have flag set to download source packages; this setting could be controlled on per-mirror basis with -with-sources flag

ppaDistributorID, ppaCodename

specifies paramaters for short PPA url expansion, if left blank they default to output of lsb_release command

S3PublishEndpoints

configuration of Amazon S3 publishing endpoints (see below)

S3 PUBLISHING ENDPOINTS

aptly could be configured to publish repository directly to Amazon S3. First, publishing endpoints should be described in aptly configuration file. Each endpoint has name and associated settings:

region

Amazon region for S3 bucket (e.g. us-east-1)

bucket

bucket name

prefix

(optional) do publishing under specified prefix in the bucket, defaults to no prefix (bucket root)

acl

(optional) assign ACL to published files (one of the canned ACLs in Amazon terminology). Useful values: private (default) or public-read (public repository). Public repositories could be consumed by apt using HTTP endpoint (Amazon bucket should be configured for "website hosting"), for private repositories special apt S3 transport is required.

awsAccessKeyID, awsSecretAccessKey

(optional) Amazon credentials to access S3 bucket. If not supplied, environment variables AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY are used.

storageClass

(optional) Amazon S3 storage class, defaults to STANDARD. Other values available: REDUCED_REDUNDANCY (lower price, lower redundancy)

encryptionMethod

(optional) server-side encryption method, defaults to none. Currently the only available encryption method is AES256

plusWorkaround

(optional) workaround misbehavior in apt and Amazon S3 for files with + in filename by creating two copies of package files with + in filename: one original and another one with spaces instead of plus signs With plusWorkaround enabled, package files with plus sign would be stored twice. aptly might not cleanup files with spaces when published repository is dropped or updated (switched) to new version of repository (snapshot).

In order to publish to S3, specify endpoint as s3:endpoint-name: before publishing prefix on the command line, e.g.:

aptly publish snapshot wheezy-main s3:test:

PACKAGE QUERY

Some commands accept package queries to identify list of packages to process. Package query syntax almost matches reprepro query language. Query consists of the following simple terms:

direct package reference

reference to exaclty one package. Format is identical to the way aptly lists packages in show commands with -with-packages flag: name_version_arch, e.g.: libmysqlclient18_5.5.35-rel33.0-611.squeeze_amd64

dependency condition

syntax follows Debian dependency specification: package_name followed by optional version specification and architecture limit, e.g: mysql-client (>= 3.6).

query against package fields

syntax is the same as for dependency conditions, but instead of package name field name is used, e.g: Priority (optional).

Supported fields:

\[ci]

all field names from Debian package control files are supported except for Filename, MD5sum, SHA1, SHA256, Size, Files, Checksums-SHA1, Checksums-SHA256.

\[ci]

$Source is a name of source package (for binary packages)

\[ci]

$SourceVersion is a version of source package

\[ci]

$Architecture is Architecture for binary packages and source for source packages, when matching with equal (=) operator, package with any architecture matches all architectures but source.

\[ci]

$Version has the same value as Version, but comparison operators use Debian version precedence rules

\[ci]

$PackageType is deb for binary packages and source for source packages

Operators:

=

strict match, default operator is no operator is given

>=, <=, =, >> (strictly greater), << (strictly less)

lexicographical comparison for all fields and special rules when comparing package versions

%

pattern matching, like shell patterns, supported special symbols are: [^]?*, e.g.: $Version (% 3.5-*)

~

regular expression matching, e.g.: Name (~ .*-dev)

Simple terms could be combined into more complex queries using operators , (and), | (or) and ! (not), parentheses () are used to change operator precedence. Match value could be enclosed in single (\(cq) or double (") quotes if required to resolve ambiguity, quotes inside quoted string should escaped with slash (\).

Examples:

mysql-client

matches package mysql-client of any version and architecture (including source), also matches packages that Provide: mysql-client.

mysql-client (>= 3.6)

matches package mysql-client with version greater or equal to 3.6. Valid operators for version are: >=, <=, =, >> (strictly greater), << (strictly less).

mysql-client {i386}

matches package mysql-client on architecture i386, architecture all matches all architectures but source.

mysql-client (>= 3.6) {i386}

version and architecture conditions combined.

libmysqlclient18_5.5.35-rel33.0-611.squeeze_amd64

direct package reference.

$Source (nginx)

all binary packages with nginx as source package.

!Name (~ .*-dev), mail-transport, $Version (>= 3.5)

matches all packages that provide mail-transport with name that has no suffix -dev and with version greater or equal to 3.5.

When specified on command line, query may have to be quoted according to shell rules, so that it stays single argument:

aptly repo import percona stable \(cqmysql-client (>= 3.6)\(cq

GLOBAL OPTIONS

-architectures=

list of architectures to consider during (comma-separated), default to all available

-config=

location of configuration file (default locations are /etc/aptly.conf, ~/.aptly.conf)

-dep-follow-all-variants=false

when processing dependencies, follow a & b if depdency is \(cqa|b\(cq

-dep-follow-recommends=false

when processing dependencies, follow Recommends

-dep-follow-source=false

when processing dependencies, follow from binary to Source packages

-dep-follow-suggests=false

when processing dependencies, follow Suggests

CREATE NEW MIRROR

aptly mirror create name archive url distribution [component1 \|.\|.\|.]

Creates mirror name of remote repository, aptly supports both regular and flat Debian repositories exported via HTTP and FTP. aptly would try download Release file from remote repository and verify its\(cq signature. Command line format resembles apt utlitily sources.list(5).

PPA urls could specified in short format:

$ aptly mirror create name ppa:user/project

Example:

$ aptly mirror create wheezy-main http://mirror.yandex.ru/debian/ wheezy main

Options:

-filter=

filter packages in mirror

-filter-with-deps=false

when filtering, include dependencies of matching packages as well

-ignore-signatures=false

disable verification of Release file signatures

-keyring=

gpg keyring to use when verifying Release file (could be specified multiple times)

-with-sources=false

download source packages in addition to binary packages

-with-udebs=false

download .udeb packages (Debian installer support)

LIST MIRRORS

aptly mirror list

List shows full list of remote repository mirrors.

Example:

$ aptly mirror list

Options:

-raw=false

display list in machine-readable format

SHOW DETAILS ABOUT MIRROR

aptly mirror show name

Shows detailed information about the mirror.

Example:

$ aptly mirror show wheezy-main

Options:

-with-packages=false

show detailed list of packages and versions stored in the mirror

DELETE MIRROR

aptly mirror drop name

Drop deletes information about remote repository mirror name. Package data is not deleted (since it could still be used by other mirrors or snapshots). If mirror is used as source to create a snapshot, aptly would refuse to delete such mirror, use flag -force to override.

Example:

$ aptly mirror drop wheezy-main

Options:

-force=false

force mirror deletion even if used by snapshots

UPDATE MIRROR

aptly mirror update name

Updates remote mirror (downloads package files and meta information). When mirror is created, this command should be run for the first time to fetch mirror contents. This command can be run multiple times to get updated repository contents. If interrupted, command can be safely restarted.

Example:

$ aptly mirror update wheezy-main

Options:

-download-limit=0

limit download speed (kbytes/sec)

-force=false

force update mirror even if it is locked by another process

-ignore-checksums=false

ignore checksum mismatches while downloading package files and metadata

-ignore-signatures=false

disable verification of Release file signatures

-keyring=

gpg keyring to use when verifying Release file (could be specified multiple times)

RENAMES MIRROR

aptly mirror rename old-name new-name

Command changes name of the mirror.Mirror name should be unique.

Example:

$ aptly mirror rename wheezy-min wheezy-main

EDIT MIRROR SETTINGS

aptly mirror edit name

Command edit allows one to change settings of mirror: filters, list of architectures.

Example:

$ aptly mirror edit -filter=nginx -filter-with-deps some-mirror

Options:

-filter=

filter packages in mirror

-filter-with-deps=false

when filtering, include dependencies of matching packages as well

-with-sources=false

download source packages in addition to binary packages

-with-udebs=false

download .udeb packages (Debian installer support)

SEARCH MIRROR FOR PACKAGES MATCHING QUERY

aptly mirror search name package-query

Command search displays list of packages in mirror that match package query

Example:

  • $ aptly mirror search wheezy-main \(cq$Architecture (i386), Name (% *-dev)\(cq
    

Options:

-with-deps=false

include dependencies into search results

ADD PACKAGES TO LOCAL REPOSITORY

aptly repo add name

Command adds packages to local repository from .deb, .udeb (binary packages) and .dsc (source packages) files. When importing from directory aptly would do recursive scan looking for all files matching .[u]deb or.dsc patterns. Every file discovered would be analyzed to extract metadata, package would then be created and added to the database. Files would be imported to internal package pool. For source packages, all required files are added automatically as well. Extra files for source package should be in the same directory as *.dsc file.

Example:

$ aptly repo add testing myapp-0.1.2.deb incoming/

Options:

-force-replace=false

when adding package that conflicts with existing package, remove existing package

-remove-files=false

remove files that have been imported successfully into repository

COPY PACKAGES BETWEEN LOCAL REPOSITORIES

aptly repo copy src-name dst-name package-query \|.\|.\|.

Command copy copies packages matching package-query from local repo src-name to local repo dst-name.

Example:

$ aptly repo copy testing stable \(cqmyapp (=0.1.12)\(cq

Options:

-dry-run=false

don\(cqt copy, just show what would be copied

-with-deps=false

follow dependencies when processing package-spec

CREATE LOCAL REPOSITORY

aptly repo create name

Create local package repository. Repository would be empty when created, packages could be added from files, copied or moved from another local repository or imported from the mirror.

Example:

$ aptly repo create testing

Options:

-comment=

any text that would be used to described local repository

-component=main

default component when publishing

-distribution=

default distribution when publishing

DELETE LOCAL REPOSITORY

aptly repo drop name

Drop information about deletions from local repo. Package data is not deleted (since it could be still used by other mirrors or snapshots).

Example:

$ aptly repo drop local-repo

Options:

-force=false

force local repo deletion even if used by snapshots

EDIT PROPERTIES OF LOCAL REPOSITORY

aptly repo edit name

Command edit allows one to change metadata of local repository: comment, default distribution and component.

Example:

$ aptly repo edit -distribution=wheezy testing

Options:

-comment=

any text that would be used to described local repository

-component=

default component when publishing

-distribution=

default distribution when publishing

IMPORT PACKAGES FROM MIRROR TO LOCAL REPOSITORY

aptly repo import src-mirror dst-repo package-query \|.\|.\|.

Command import looks up packages matching package-query in mirror src-mirror and copies them to local repo dst-repo.

Example:

$ aptly repo import wheezy-main testing nginx

Options:

-dry-run=false

don\(cqt import, just show what would be imported

-with-deps=false

follow dependencies when processing package-spec

LIST LOCAL REPOSITORIES

aptly repo list

List command shows full list of local package repositories.

Example:

$ aptly repo list

Options:

-raw=false

display list in machine-readable format

MOVE PACKAGES BETWEEN LOCAL REPOSITORIES

aptly repo move src-name dst-name package-query \|.\|.\|.

Command move moves packages matching package-query from local repo src-name to local repo dst-name.

Example:

$ aptly repo move testing stable \(cqmyapp (=0.1.12)\(cq

Options:

-dry-run=false

don\(cqt move, just show what would be moved

-with-deps=false

follow dependencies when processing package-spec

REMOVE PACKAGES FROM LOCAL REPOSITORY

aptly repo remove name package-query \|.\|.\|.

Commands removes packages matching package-query from local repository name. If removed packages are not referenced by other repos or snapshots, they can be removed completely (including files) by running \(cqaptly db cleanup\(cq.

Example:

$ aptly repo remove testing \(cqmyapp (=0.1.12)\(cq

Options:

-dry-run=false

don\(cqt remove, just show what would be removed

SHOW DETAILS ABOUT LOCAL REPOSITORY

aptly repo show name

Show command shows full information about local package repository.

ex: $ aptly repo show testing

Options:

-with-packages=false

show list of packages

RENAMES LOCAL REPOSITORY

aptly repo rename old-name new-name

Command changes name of the local repo. Local repo name should be unique.

Example:

$ aptly repo rename wheezy-min wheezy-main

SEARCH REPO FOR PACKAGES MATCHING QUERY

aptly repo search name package-query

Command search displays list of packages in local repository that match package query

Example:

  • $ aptly repo search my-software \(cq$Architecture (i386), Name (% *-dev)\(cq
    

Options:

-with-deps=false

include dependencies into search results

CREATES SNAPSHOT OF MIRROR (LOCAL REPOSITORY) CONTENTS

aptly snapshot create name from mirror mirror-name | from repo repo-name | empty

Command create name from mirror makes persistent immutable snapshot of remote repository mirror. Snapshot could be published or further modified using merge, pull and other aptly features.

Command create name from repo makes persistent immutable snapshot of local repository. Snapshot could be processed as mirror snapshots, and mixed with snapshots of remote mirrors.

Command create name empty creates empty snapshot that could be used as a basis for snapshot pull operations, for example. As snapshots are immutable, creating one empty snapshot should be enough.

Example:

$ aptly snapshot create wheezy-main-today from mirror wheezy-main

LIST SNAPSHOTS

aptly snapshot list

Command list shows full list of snapshots created.

Example:

$ aptly snapshot list

Options:

-raw=false

display list in machine-readable format

-sort=name

display list in \(cqname\(cq or creation \(cqtime\(cq order

SHOWS DETAILS ABOUT SNAPSHOT

aptly snapshot show name

Command show displays full information about a snapshot.

Example:

  • $ aptly snapshot show wheezy-main
    

Options:

-with-packages=false

show list of packages

VERIFY DEPENDENCIES IN SNAPSHOT

aptly snapshot verify name [source \|.\|.\|.]

Verify does dependency resolution in snapshot name, possibly using additional snapshots source as dependency sources. All unsatisfied dependencies are printed.

Example:

  • $ aptly snapshot verify wheezy-main wheezy-contrib wheezy-non-free
    

PULL PACKAGES FROM ANOTHER SNAPSHOT

aptly snapshot pull name source destination package-query \|.\|.\|.

Command pull pulls new packages along with its\(cq dependencies to snapshot name from snapshot source. Pull can upgrade package version in name with versions from source following dependencies. New snapshot destination is created as a result of this process. Packages could be specified simply as \(cqpackage-name\(cq or as package queries.

Example:

  • $ aptly snapshot pull wheezy-main wheezy-backports wheezy-new-xorg xorg-server-server
    

Options:

-all-matches=false

pull all the packages that satisfy the dependency version requirements

-dry-run=false

don\(cqt create destination snapshot, just show what would be pulled

-no-deps=false

don\(cqt process dependencies, just pull listed packages

-no-remove=false

don\(cqt remove other package versions when pulling package

DIFFERENCE BETWEEN TWO SNAPSHOTS

aptly snapshot diff name-a name-b

Displays difference in packages between two snapshots. Snapshot is a list of packages, so difference between snapshots is a difference between package lists. Package could be either completely missing in one snapshot, or package is present in both snapshots with different versions.

Example:

  • $ aptly snapshot diff -only-matching wheezy-main wheezy-backports
    

Options:

-only-matching=false

display diff only for matching packages (don\(cqt display missing packages)

MERGES SNAPSHOTS

aptly snapshot merge destination source [source\|.\|.\|.]

Merge command merges several source snapshots into one destination snapshot. Merge happens from left to right. By default, packages with the same name-architecture pair are replaced during merge (package from latest snapshot on the list wins). If run with only one source snapshot, merge copies source into destination.

Example:

  • $ aptly snapshot merge wheezy-w-backports wheezy-main wheezy-backports
    

Options:

-latest=false

use only the latest version of each package

-no-remove=false

don\(cqt remove duplicate arch/name packages

DELETE SNAPSHOT

aptly snapshot drop name

Drop removes information about a snapshot. If snapshot is published, it can\(cqt be dropped.

Example:

  • $ aptly snapshot drop wheezy-main
    

Options:

-force=false

remove snapshot even if it was used as source for other snapshots

RENAMES SNAPSHOT

aptly snapshot rename old-name new-name

Command changes name of the snapshot. Snapshot name should be unique.

Example:

$ aptly snapshot rename wheezy-min wheezy-main

SEARCH SNAPSHOT FOR PACKAGES MATCHING QUERY

aptly snapshot search name package-query

Command search displays list of packages in snapshot that match package query

Example:

  • $ aptly snapshot search wheezy-main \(cq$Architecture (i386), Name (% *-dev)\(cq
    

Options:

-with-deps=false

include dependencies into search results

FILTER PACKAGES IN SNAPSHOT PRODUCING ANOTHER SNAPSHOT

aptly snapshot filter source destination package-query \|.\|.\|.

Command filter does filtering in snapshot source, producing another snapshot destination. Packages could be specified simply as \(cqpackage-name\(cq or as package queries.

Example:

  • $ aptly snapshot filter wheezy-main wheezy-required \(cqPriorioty (required)\(cq
    

Options:

-with-deps=false

include dependent packages as well

REMOVE PUBLISHED REPOSITORY

aptly publish drop distribution [[endpoint:]prefix]

Command removes whatever has been published under specified prefix, publishing endpoint and distribution name.

Example:

  • $ aptly publish drop wheezy
    

LIST OF PUBLISHED REPOSITORIES

aptly publish list

Display list of currently published snapshots.

Example:

  • $ aptly publish list
    

Options:

-raw=false

display list in machine-readable format

PUBLISH LOCAL REPOSITORY

aptly publish repo name [[endpoint:]prefix]

Command publishes current state of local repository ready to be consumed by apt tools. Published repostiories appear under rootDir/public directory. Valid GPG key is required for publishing.

Multiple component repository could be published by specifying several components split by commas via -component flag and multiple local repositories as the arguments:

  • aptly publish repo -component=main,contrib repo-main repo-contrib
    

It is not recommended to publish local repositories directly unless the repository is for testing purposes and changes happen frequently. For production usage please take snapshot of repository and publish it using publish snapshot command.

Example:

  • $ aptly publish repo testing
    

Options:

-component=

component name to publish (for multi-component publishing, separate components with commas)

-distribution=

distribution name to publish

-force-overwrite=false

overwrite files in package pool in case of mismatch

-gpg-key=

GPG key ID to use when signing the release

-keyring=

GPG keyring to use (instead of default)

-label=

label to publish

-origin=

origin name to publish

-passphrase=

GPG passhprase for the key (warning: could be insecure)

-passphrase-file=

GPG passhprase-file for the key (warning: could be insecure)

-secret-keyring=

GPG secret keyring to use (instead of default)

-skip-signing=false

don\(cqt sign Release files with GPG

PUBLISH SNAPSHOT

aptly publish snapshot name [[endpoint:]prefix]

Command publishes snapshot as Debian repository ready to be consumed by apt tools. Published repostiories appear under rootDir/public directory. Valid GPG key is required for publishing.

Multiple component repository could be published by specifying several components split by commas via -component flag and multiple snapshots as the arguments:

  • aptly publish snapshot -component=main,contrib snap-main snap-contrib
    

Example:

  • $ aptly publish snapshot wheezy-main
    

Options:

-component=

component name to publish (for multi-component publishing, separate components with commas)

-distribution=

distribution name to publish

-force-overwrite=false

overwrite files in package pool in case of mismatch

-gpg-key=

GPG key ID to use when signing the release

-keyring=

GPG keyring to use (instead of default)

-label=

label to publish

-origin=

origin name to publish

-passphrase=

GPG passhprase for the key (warning: could be insecure)

-passphrase-file=

GPG passhprase-file for the key (warning: could be insecure)

-secret-keyring=

GPG secret keyring to use (instead of default)

-skip-signing=false

don\(cqt sign Release files with GPG

UPDATE PUBLISHED REPOSITORY BY SWITCHING TO NEW SNAPSHOT

aptly publish switch distribution [[endpoint:]prefix] new-snapshot

Command switches in-place published repository with new snapshot contents. All publishing parameters are preserved (architecture list, distribution, component).

For multiple component repositories, flag -component should be given with list of components to update. Corresponding snapshots should be given in the same order, e.g.:

  • aptly publish update -component=main,contrib wheezy wh-main wh-contrib
    

Example:

  • $ aptly publish update wheezy ppa wheezy-7.5
    

Options:

-component=

component names to update (for multi-component publishing, separate components with commas)

-force-overwrite=false

overwrite files in package pool in case of mismatch

-gpg-key=

GPG key ID to use when signing the release

-keyring=

GPG keyring to use (instead of default)

-passphrase=

GPG passhprase for the key (warning: could be insecure)

-passphrase-file=

GPG passhprase-file for the key (warning: could be insecure)

-secret-keyring=

GPG secret keyring to use (instead of default)

-skip-signing=false

don\(cqt sign Release files with GPG

UPDATE PUBLISHED LOCAL REPOSITORY

aptly publish update distribution [[endpoint:]prefix]

Command re-publishes (updates) published local repository. distribution and prefix should be occupied with local repository published using command aptly publish repo. Update happens in-place with minimum possible downtime for published repository.

For multiple component published repositories, all local repositories are updated.

Example:

  • $ aptly publish update wheezy ppa
    

Options:

-force-overwrite=false

overwrite files in package pool in case of mismatch

-gpg-key=

GPG key ID to use when signing the release

-keyring=

GPG keyring to use (instead of default)

-passphrase=

GPG passhprase for the key (warning: could be insecure)

-passphrase-file=

GPG passhprase-file for the key (warning: could be insecure)

-secret-keyring=

GPG secret keyring to use (instead of default)

-skip-signing=false

don\(cqt sign Release files with GPG

SEARCH FOR PACKAGES MATCHING QUERY

aptly package search package-query

Command search displays list of packages in whole DB that match package query

Example:

  • $ aptly package search \(cq$Architecture (i386), Name (% *-dev)\(cq
    

SHOW DETAILS ABOUT PACKAGES MATCING QUERY

aptly package show package-query

Command shows displays detailed meta-information about packages matching query. Information from Debian control file is displayed. Optionally information about package files and inclusion into mirrors/snapshots/local repos is shown.

Example:

  • $ aptly package show nginx-light_1.2.1-2.2+wheezy2_i386\(cq
    

Options:

-with-files=false

display information about files from package pool

-with-references=false

display information about mirrors, snapshots and local repos referencing this package

CLEANUP DB AND PACKAGE POOL

aptly db cleanup

Database cleanup removes information about unreferenced packages and removes files in the package pool that aren\(cqt used by packages anymore

Example:

$ aptly db cleanup

RECOVER DB AFTER CRASH

aptly db recover

Database recover does its\(cq best to recover the database after a crash. It is recommended to backup the DB before running recover.

Example:

$ aptly db recover

HTTP SERVE PUBLISHED REPOSITORIES

aptly serve

Command serve starts embedded HTTP server (not suitable for real production usage) to serve contents of public/ subdirectory of aptly\(cqs root that contains published repositories.

Example:

$ aptly serve -listen=:8080

Options:

-listen=:8080

host:port for HTTP listening

RENDER GRAPH OF RELATIONSHIPS

aptly graph

Command graph displays relationship between mirrors, local repositories, snapshots and published repositories using graphviz package to render graph as an image.

Example:

$ aptly graph

ENVIRONMENT

If environment variable HTTP_PROXY is set aptly would use its value to proxy all HTTP requests.

RETURN VALUES

aptly exists with:

0

success

1

general failure

2

command parse failure

AUTHORS

Andrey Smirnov ([email protected])