Akten & Vorgänge
Fasse zusammengehörige Unterlagen in Akten und Vorgängen zusammen. Ergänze Notizen und behalte Fristen im Blick.
INSTALLATION & EINSTIEG
Deine Unterlagen.
Dein Aktenquartier.
Gib deinen Dokumenten einen Zusammenhang. Aktenquartier ergänzt dein Paperless-ngx um Akten, Vorgänge, Ablage und Fristen – auf deinem eigenen Server.
WAS AKTENQUARTIER MACHT
Vom Dokument zur geordneten Akte.
Paperless bewahrt die Dokumente auf. In Aktenquartier organisierst du, wozu sie gehören und was als Nächstes ansteht.
Eingang & persönliche Ablage
Ordne Dokumente aus dem Paperless-Posteingang zu oder nutze eigene Ordner und Unterordner ohne Aktenpflicht.
Suche & Dokumentvorschau
Suche im erreichbaren Paperless-Bestand und öffne unterstützte Dokumente direkt in der Vorschau.
Uploads & E-Mail-Eingänge
Übertrage neue Unterlagen an Paperless und verwalte dessen E-Mail-Import. Schreibende Funktionen benötigen passende Rechte und eine ausdrückliche Freigabe.
Originale wiederfinden
Verknüpfe Paperless-ASN-Bereiche mit Papierordnern und Standorten. So bleibt sichtbar, wo ein Papieroriginal liegt.
Aufbewahrung & Löschsperren
Pflege Aufbewahrungsregeln mit explizitem Fristbeginn und Sperren. Automatische Löschaufträge sind bei der Installation ausgeschaltet.
Der verfügbare Funktionsumfang richtet sich nach veröffentlichter Version, Lizenz und Benutzerrechten. Aktenquartier ersetzt keine rechtliche Prüfung von Aufbewahrungs- oder Löschfristen.
BEVOR DU STARTEN KANNST
Das brauchst du.
Der Installer richtet Aktenquartier ein. Linux, Docker und deine Paperless-Installation müssen bereits bereitstehen.
Server & Software
- Linux mit systemdRoot-Zugang oder sudo-Rechte für die Installation und den Update-Dienst.
- Docker Engine & Docker ComposeLokaler, rootful Docker-Dienst im Kontext
default. Docker Desktop, Remote-Docker und Rootless-Docker sind für diesen Installer nicht vorgesehen. - Python ab 3.10, OpenSSL & curlPython und OpenSSL müssen auch unter
/usr/binverfügbar sein. Auf deinem Windows-PC wird der Installer nicht ausgeführt. - Mindestens 3 GiB freier SpeicherDas ist die Startprüfung des Installers, keine vollständige Kapazitätsplanung. Zusätzlichen Platz für Images, Datenbank, Protokolle und Backups vorsehen.
Zugänge & Netzwerk
- Bestehendes Paperless-ngxErreichbare Basisadresse und Benutzer-API-Token. Paperless wird nicht mitinstalliert.
- AQ-LizenzschlüsselAuch für die kostenlose Basisversion erforderlich. Eine Pro-Lizenz ist keine Voraussetzung für die Installation.
- Eigene HTTPS-AdresseReverse Proxy mit eigener Domain oder Subdomain. Aktenquartier wird unter
/betrieben, nicht unter einem Unterpfad. - Ausgehender InternetzugriffHTTPS zu Lizenz- und Downloadserver sowie Zugriff auf die beim Image-Bau verwendeten Paket- und Containerquellen.
ionCube Loader erforderlich – im Docker-Paket bereits enthalten.
Die geschützten PHP-Dateien von Aktenquartier benötigen den ionCube Loader. Er ermöglicht die Ausführung des kodierten Anwendungscodes und schützt damit den ausgelieferten Quellcode. Er ersetzt weder die Verschlüsselung deiner Dokumente noch Backups.
Bei der Installation mit unserem Installer wird der passende Loader für PHP 8.4 im App-Image eingebunden und beim Image-Bau geprüft. Auf dem Linux-Host musst du weder PHP noch ionCube separat installieren. Ein eigener ionCube Encoder ist für die Nutzung nicht erforderlich.
Der geschützte Docker-Paketaufbau unterstützt Linux amd64 und arm64. Gewöhnliches PHP-Webhosting ist nicht der hier beschriebene Installationsweg. Informationen des ionCube-Herstellers
Keine lokale PHP- oder MariaDB-Installation nötig.
Die Anwendung und ihre Datenbank werden im eigenen Docker-Projekt betrieben. Die Dokumentdateien bleiben in deiner separaten Paperless-Installation.
Docker noch nicht installiert? Verwende die offizielle Anleitung für Ubuntu oder Debian. Achte auf das zum Betriebssystem passende Repository.
KURZE CHECKLISTE
Diese Angaben bereitlegen.
| Angabe | Wofür sie gebraucht wird |
|---|---|
| AQ-Lizenzschlüssel | Aktiviert die Installation und erlaubt den Abruf der freigegebenen Anwendung. |
| HTTPS-Adresse von Aktenquartier | Zum Beispiel https://akten.example.de. Diese Adresse richtest du am Reverse Proxy ein. |
| Bindeadresse & Port | 127.0.0.1:8088 bei einem Proxy auf demselben Host. Bei einem getrennten NetBird-Proxy die NetBird-IP des AQ-Servers und einen freien Port verwenden. |
| Erster Administrator | Benutzername sowie ein Passwort mit 12–72 Bytes. Zeichen außerhalb von ASCII können mehrere Bytes benötigen. |
| Paperless-Basisadresse | Aus dem AQ-Container erreichbar, ohne /api oder weiteren Unterpfad. Beispiel: http://192.168.10.20:8000. |
| Paperless-Browseradresse | Optional abweichende Adresse, die deine Benutzer im Browser erreichen. Leer lassen, wenn sie der API-Basisadresse entspricht. |
| Paperless-Benutzer-API-Token | Mit den benötigten Rechten auf die vorgesehenen Dokumente. Der Token bleibt auf dem Server und wird verdeckt eingegeben. |
Privater Zugriff über NetBird ist möglich.
Binde Aktenquartier an die NetBird-IP des Servers und erlaube dem Proxy den Zugriff auf den gewählten Port. Für eine private Oberfläche zusätzlich NetBird-Only Access mit berechtigten Geräten am Proxy-Service verwenden. Prüfe auch bestehende breite Netzwerkfreigaben.
SCHRITT FÜR SCHRITT
Aktenquartier installieren.
Führe die Befehle im Terminal deines Linux-Servers aus. Die Installation bleibt interaktiv; Zugangsdaten gehören nicht in die Befehlszeile.
Voraussetzungen prüfen
Diese Befehle zeigen die vorhandenen Versionen und prüfen die Verbindung zum lokalen Docker-Dienst.
python3 --version openssl version docker compose version sudo docker info --format '{{.ServerVersion}}' systemctl is-active dockerFehlt ein Werkzeug oder antwortet Docker nicht, behebe das zuerst. Der AQ-Installer installiert Docker nicht automatisch.
Installer herunterladen und Prüfsumme vergleichen
Dieser Block legt einen neuen Downloadordner an. Lege das spätere AQ-Installationsverzeichnis noch nicht selbst an.
AQ_DOWNLOAD_DIR=$(mktemp -d "$HOME/aq-install.XXXXXX") && cd "$AQ_DOWNLOAD_DIR" && curl --fail --show-error --location --proto '=https' --tlsv1.2 \ https://downloads.mmde.it/aktenquartier/installer.pyz \ --output aktenquartier-installer.pyz && curl --fail --show-error --location --proto '=https' --tlsv1.2 \ https://downloads.mmde.it/aktenquartier/installer.pyz.sha256 \ --output aktenquartier-installer.pyz.sha256 && sha256sum --check aktenquartier-installer.pyz.sha256Erwartet wird
aktenquartier-installer.pyz: OK. Bei einem fehlgeschlagenen Download oder einer abweichenden Prüfsumme nicht fortfahren.Assistenten starten
sudo python3 aktenquartier-installer.pyzStandardmäßig wird eine neue Installation unter
/opt/aktenquartiermit dem Projektnamenaktenquartierund dem Kanal Stable angelegt. Ein bereits belegtes Ziel oder vorhandene fremde Datenvolumes werden abgewiesen.Gib die vorbereiteten Angaben ein und bestätige das neue Installationsziel. Lizenzschlüssel, API-Token und Passwort werden verdeckt abgefragt. Wenn du bereits als root angemeldet bist, kannst du
sudoweglassen.Einrichtung abschließen lassen
Der Assistent aktiviert die Lizenz, prüft die signierte Veröffentlichung, baut das App-Image und startet das eigene Docker-Projekt. Danach prüft er die Paperless-Verbindung, richtet den ersten Zugang sowie den separaten Update-Dienst ein und kontrolliert das Ergebnis.
Paperless-Schreibzugriffe und automatische Löschaufträge bleiben zunächst aus. Der Installer übernimmt keine fremde Paperless-Datenbank und ersetzt keine bestehende AQ-Installation.
HTTPS-Zugriff einrichten und anmelden
Trage am Reverse Proxy die gewählte Bindeadresse und den Port als Backend ein. Öffne anschließend die im Assistenten angegebene HTTPS-Adresse und melde dich mit deinem ersten AQ-Administrator an.
Bei einem getrennten Proxy funktioniert
127.0.0.1des AQ-Servers nicht als entferntes Ziel. Verwende dafür eine vom Proxy erreichbare private Adresse, beispielsweise die NetBird-IP.
NACH DER INSTALLATION
Deine ersten Schritte.
Verbindung prüfen
Suche ein bekanntes Paperless-Dokument und öffne seine Vorschau. Prüfe, ob die vorgesehenen Dokumente erreichbar sind.
Eine erste Akte anlegen
Lege eine Akte oder einen Ordner in „Meine Ablage“ an und ordne zunächst wenige Testdokumente zu.
Updates & Sicherungen einrichten
Prüfe unter „Einstellungen → System, Lizenz & Updates“ den Status. Sichere AQ-Datenbank und Konfiguration sowie Paperless-Datenbank und Dokumentdateien separat.
Teste die Wiederherstellung einer Sicherung in einer getrennten Umgebung. Ein erfolgreicher Installationslauf richtet noch kein vollständiges externes Backup ein.
GUT ZU WISSEN
Fragen vor und nach dem Start.
Was tun bei „ionCube Loader not installed“?
Die Meldung bedeutet, dass geschützter PHP-Code ohne passenden Loader ausgeführt wird. Verwende das zur Veröffentlichung gehörende Docker-Paket und dessen Image-Bau. Bei einer eigenen PHP-Umgebung müssen PHP-Version, Architektur und Loader zusammenpassen. Das Kopieren der Dateien in beliebiges Webhosting ersetzt die Docker-Installation nicht.
Ist Paperless wirklich erforderlich?
Ja. Der Kunden-Installer benötigt eine erreichbare Paperless-ngx-Installation und einen gültigen Benutzer-API-Token. Paperless übernimmt Archivierung und Dokumentenverarbeitung; Aktenquartier ergänzt die Organisation.
Brauche ich eine Pro-Lizenz?
Für die Installation genügt ein gültiger AQ-Lizenzschlüssel für die kostenlose Basisversion. Welche Zusatzfunktionen deine Lizenz freischaltet, siehst du in deinem Lizenzstatus.
Kann ich Aktenquartier direkt unter Windows installieren?
Der Installer läuft auf einem Linux-Server mit systemd und lokalem Docker Engine. Unter Windows kannst du per SSH auf diesen Server zugreifen und Aktenquartier anschließend im Browser nutzen.
Was tun, wenn die Paperless-Prüfung fehlschlägt?
Prüfe die Basisadresse ohne /api, Netzwerkfreigaben und die Rechte des Tokens. Die Adresse muss aus dem AQ-Container erreichbar sein. Für einen lokalen Dienst ist localhost im Container meist das falsche Ziel. Zertifikatsprüfungen nicht abschalten.
Bei einer noch nicht abgeschlossenen Installation kannst du die Paperless-Angaben erneut abfragen lassen:
sudo python3 aktenquartier-installer.pyz --paperless-resetFalls du eigene Optionen für Verzeichnis, Projekt oder Kanal verwendet hast, dieselben Optionen beim Fortsetzen beibehalten.
Kann ich eine unterbrochene Installation fortsetzen?
Ja. Starte denselben Installer mit denselben Optionen erneut. Er verwendet seinen geschützten Installationszustand weiter. Lösche dafür weder Datenvolumes noch den Installationszustand.
Wie aktualisiere ich später?
Der Installer richtet einen separaten Update-Dienst ein. Prüfe neue Veröffentlichungen unter „Einstellungen → System, Lizenz & Updates“ und starte das Update bewusst. Vorher eine aktuelle Sicherung anlegen. Den Installationsassistenten nicht als Ersatz für den Updateablauf verwenden.
Kann ich öffentliche Testversionen verwenden?
Stable ist die Voreinstellung. Wenn du ausdrücklich testen möchtest, starte eine neue Testinstallation mit sudo python3 aktenquartier-installer.pyz --channel open_beta. Closed Beta benötigt eine Teamfreigabe. Der Developer-Kanal ist kein Kundenkanal.
Warum ist die Seite trotz laufender Container nicht erreichbar?
Prüfe zuerst Domain, HTTPS-Zertifikat und das Proxy-Ziel. Danach Bindeadresse, Port und Netzwerkregeln. Bei NetBird-Only Access muss auch das zugreifende Gerät verbunden und für den Service berechtigt sein.
sudo docker compose --project-name aktenquartier \
--project-directory /opt/aktenquartier \
--env-file /opt/aktenquartier/.env \
-f /opt/aktenquartier/compose.yml psDer Befehl gilt für die Standardinstallation. Bei eigenen Namen oder Pfaden entsprechend anpassen. Teile keine vollständigen Konfigurationsausgaben, Passwörter oder API-Token.
BEREIT FÜR DEIN AKTENQUARTIER?
Beginne mit den Voraussetzungen.
Paperless bereitstellen, Zugänge bereitlegen und den Assistenten auf deinem Server starten.