Die Verzeichnisstruktur eines komplexen (oder auch „automatischen“) Repositorys stellt sich für die verschiedenen Debian-Architekturen und Bereiche wie folgt dar:

(Wurzelverzeichnis des Repositories) 
| 
+-dists
  | 
  |-stable
  | |-main
  | | |-binary-alpha 
  | | |-binary-arm
  | | |-binary-...
  | | +-source 
  | |-contrib
  | | |-binary-alpha 
  | | |-binary-arm
  | | |-binary-...
  | | +-source 
  | +-non-free
  |   |-binary-alpha
  |   |-binary-arm
  |   |-binary-...
  |   +-source
  |
  |-testing 
  | |-main
  | | |-binary-alpha 
  | | |-binary-arm
  | | |-binary-...
  | | +-source 
  | |-contrib
  | | |-binary-alpha 
  | | |-binary-arm
  | | |-binary-...
  | | +-source 
  | +-non-free
  |   |-binary-alpha
  |   |-binary-arm
  |   |-binary-...
  |   +-source
  |
  +-unstable 
    |-main
    | |-binary-alpha 
    | |-binary-arm
    | |-binary-...
    | +-source 
    |-contrib
    | |-binary-alpha 
    | |-binary-arm
    | |-binary-...
    | +-source 
    +-non-free
      |-binary-alpha
      |-binary-arm
      |-binary-...
      +-source

Pakete, die einer freien Lizenz unterliegen (siehe Debian Free Software Guidelines) finden sich im Bereich „main“. Nicht-freie Software befindet sich in „non-free“, und in „contrib“ finden sich freie Pakete, die aber auf nicht-freien Paketen basieren. Debian unterstützt eine Anzahl weiterer Hardware-Architekturen, die in diesem Beispiel nicht alle aufgeführt sind.

In jedem binary-...-Verzeichnis befindet sich eine Index-Datei Packages.gz sowie eine optionale Datei Release. Die Pakete müssen nicht im Verzeichnis der Index-Datei liegen, da die Pfade zu den Paketen in der Index-Datei stehen. Dies ermöglicht es, sogenannte „Package-Pools“ zu erzeugen.

Es können beliebig viele Architekturen und Bereiche mit beliebigen Namen angelegt werden.

Einfache Repositories bestehen aus einem Wurzelverzeichnis und beliebig vielen Unterverzeichnissen. Da die Benutzer sowohl das Wurzelverzeichnis als auch den relativen Pfad zu den Unterverzeichnissen angeben müssen, kann hier eine beliebige Struktur angelegt werden. So können auch alle Dateien (Index-Dateien und Pakete) im Wurzelverzeichnis liegen. Hier sehen Sie ein einfaches Repository mit zwei Unterverzeichnissen:

(Wurzelverzeichnis des Repositorys) 
|
|-binary
+-source

Das Erzeugen der Index-Dateien für Binärpakete übernimmt das Programm dpkg-scanpackages (siehe dpkg-scanpackages ) bzw. dpkg-scansources (siehe dpkg-scansources für die Quellcodepakete. Beide Programme erzeugen die Ausgabe auf der Standard-Ausgabe, so dass dieses Ergebnis in eine Datei umgeleitet werden muss. Um die entstehenden Dateien zu komprimieren, kann im gleichen Arbeitsschritt noch das Programm gzip verwendet werden. Für ein einfaches Repository können die Index-Dateien für die Binär- und Quellcode-Pakete wie folgt erstellt werden:

$ cd Pfad/zum/Repository
$ dpkg-scanpackages binary /dev/null | gzip -9c > binary/Packages.gz
$ dpkg-scansources source | gzip -9c > source/Sources.gz

Eine detaillierte Anleitung zu den beiden Programmen findet sich in den oben beschriebenen Abschnitten, dort wird auch auf die notwendigen Argumente eingegangen.

include_once("parse-apt-files.inc");
parse_and_list( "Packages.gz", "Sources.gz" );

include_once("parse-apt-files.inc");
parse_and_list( Array("i386/Packages.gz", "powerpc/Packages.gz"), "Sources.gz" );

Um das „Pinning“ von Paketen zu ermöglichen (siehe Pinning ) muss eine Release-Datei in jedem Verzeichnis, in dem sich eine Index-Datei befindet, zur Verfügung gestellt werden. Release-Dateien sind einfach Text-Dateien mit folgendem Aufbau:

Archive: archive
Component: component
Origin: YourCompany
Label: YourCompany Debian repository
Architecture: architecture

Zum Erzeugen dieser Dateien kann auch das in „Verwaltung des Spiegels“ beschriebene Skript verwendet werden.

Insbesondere müssen Sie darauf achten, dass die Angaben zu Archive und Architecture korrekt sind, da diese am häufigsten für das Pinning von Paketen eingesetzt werden. Alle anderen Angaben sind eher unwichtig.

Bei komplexen Repositories führt die umfangreiche Verzeichnisstruktur schnell zur Unübersichtlichkeit und auch zur Verschwendung von Plattenplatz, da viele Pakete (beispielsweise Dokumentation) für unterschiedliche Architekturen geeignet sind. Diese Pakete müssen nicht mehrfach im Repository vorgehalten werden.

Die Lösung dieses Problems sind so genannte „Package Pools“. Ein Pool ist ein gesondertes Verzeichnis unterhalb des Wurzelverzeichnisses des Repositorys, in dem alle Pakete (Binaries für alle Architekturen, für alle Distributionen und Bereiche sowie die Quellcode-Pakete) abgelegt werden. Durch die Verwendung von „override-files“ und einige Skripte können die oben genannten Probleme umgangen werden. Ein gutes Beispiel für die Verwendung eines solchen Pools ist sicherlich das Debian-Repository selbst.

Um die notwendigen Index-Dateien für ein solches Repository zu erzeugen, sollten Sie den Abschnitt zu apt-ftparchive aus dem Paket apt-utils zu Rate ziehen. Für einfache Repositories ist apt-move eine gute Hilfe.