AptlyPilot

Repository as Code Platform for Debian Package Management

Automate, manage, and monitor the complete lifecycle of Aptly repositories.

Overview

AptlyPilot is a modern management and automation platform for aptly repositories.

It provides a centralized control plane for managing Debian package repositories through declarative configuration, automation workflows, and operational visibility.

AptlyPilot helps infrastructure teams automate the complete repository lifecycle:

Mirror  ->  Snapshot  ->  Validation  ->  Publish

Why AptlyPilot?

Aptly is a powerful Debian repository management tool that provides a reliable and efficient way to create, manage, snapshot, and publish Debian package repositories. With features such as mirror management, snapshots, package version control, and atomic publishing, Aptly has become a trusted solution for managing Debian-based software repositories.

However, operating Aptly at scale requires additional capabilities for automation, abstraction, visibility, and operational control.

AptlyPilot was created to provide a modern management layer on top of Aptly, adding:

• Centralized repository management
• Declarative configuration and Repository as Code workflows
• Automated synchronization and scheduling
• Snapshot lifecycle management
• Operational visibility and monitoring
• Workflow automation and integration capabilities

AptlyPilot turns Aptly from a powerful repository engine into an operational platform for managing the complete lifecycle of Debian repositories.

Demo

2-minute overview of AptlyPilot

See Repository as Code, Aptly synchronization, repository state tracking, automated pipelines, and scheduled execution in action.

▶️ Watch the AptlyPilot Demo on YouTube

How to define Repository as Code?

Define repository lifecycle using declarative configuration.

For more information, refer to the Repository as Code documentation.

Example:

repository:
  name: debian-bookworm

mirror:
  url: http://deb.debian.org/debian
  distribution: bookworm
  components:
    - main
    - contrib

snapshot:
  retention: 10

Installation

Clone this project:

git clone https://github.com/mmayabi/AptlyPilot.git

cd AptlyPilot

Copy the environment file and edit it:

cp .env.example .env

Start AptlyPilot application:

docker compose up --build -d

API

AptlyPilot provides APIs for automation and integration.

API docs:

http://localhost:8000/docs

Health check:

curl http://localhost:8000/api/v1/health

Expected response:

{
  "status": "ok",
  "service": "aptly-pilot",
  "project": "AptlyPilot"
}

Project Status

AptlyPilot is under active development.

The goal is to provide a reliable platform for automated Debian repository lifecycle management.

Contributing

Contributions are welcome.

Please open an issue or submit a pull request.