Kontorfix

Self-hosted Registry für private Software-Pakete — mit Zugriffskontrolle, Mandantenfähigkeit und Weboberfläche. Pakete zentral veröffentlichen, einzelnen Kunden zuweisen und jedem Kunden eine isolierte Sicht geben. Composer- und npm-kompatibel.

Worum es geht

Kontorfix sammelt private Pakete an einem Ort und liefert sie unter strenger Kontrolle aus — gruppiert in Registries mit eigener Adresse, abgesichert durch widerrufbare Zugriffs-Tokens. Teams veröffentlichen zentral, weisen Pakete einzelnen Kunden zu und geben jedem Kunden eine eigene, isolierte Sicht. Alles ist über eine Weboberfläche und eine vollständige Programmierschnittstelle steuerbar. Läuft selbst gehostet auf eigener Infrastruktur, ausgeliefert als Container.

Highlights

Registries mit eigener Adresse — jede Registry unter eigenem Pfad oder eigener Domain.
Feingranulare Zugriffskontrolle — widerrufbare Tokens und persönliche Schlüssel, getrennt nach Lesen und Veröffentlichen.
Mandantenfähig — Kunden erhalten eigene Registries und ein isoliertes Portal.
Mehrere Anmeldewege — Passwort mit Zwei-Faktor, Passkeys und Single Sign-on.
Maschinenzugriff — dedizierte Service-Konten für Automatisierung und Integrationen.
Proxy & Cache — öffentliche Pakete werden gespiegelt und lokal vorgehalten.
REST-API — vollständige, versionierte Schnittstelle mit interaktiver Dokumentation (OpenAPI unter /docs/api).
Benachrichtigungen — ausgehende Event-Hooks für angebundene Systeme.
Live-Statusansicht — Betriebszustand und Aktivität auf einen Blick (per WebSockets).
Flexibler Speicher — lokal oder objektbasiert (S3-kompatibel), frei konfigurierbar.

Tech-Stack

Laravel 12 & PHP 8.2+ im Backend, Horizon (Queues) und Reverb (WebSockets für die Live-Statusansicht)
Vue 3 & TypeScript, gekoppelt über Inertia.js, gestylt mit Tailwind CSS
Passkeys (WebAuthn), 2FA (TOTP) und JWT für Tokens
Scramble für die automatisch generierte OpenAPI-Dokumentation
Flysystem (S3-kompatibel) als Speicher, composer/semver & Metadata-Minifier für die Composer-Registry
Ausgeliefert als Container; DDEV für die lokale Entwicklung

Für Entwickler

git clone https://github.com/NoiXdev/kontorfix.git
cd kontorfix
ddev start
ddev composer install
ddev exec npm install
ddev exec php artisan key:generate
ddev exec php artisan migrate --seed
ddev exec npm run dev

Tests laufen mit ddev exec vendor/bin/pest, statische Analyse mit ddev exec vendor/bin/phpstan analyse (Larastan). Deploy-Details stehen in der Entwickler- und Betriebsdokumentation im Repo.

Status

Kontorfix ist LIVE (v0.6.x) und wird aktiv weiterentwickelt. Issues und PRs sind willkommen — github.com/NoiXdev/kontorfix.