AssetManager ist eine selbst gehostete Webanwendung zur Verwaltung von IT- und sonstigen Betriebsmitteln. Das Projekt wird unter der Apache License 2.0 veröffentlicht und darf privat sowie kommerziell genutzt, verändert und weitergegeben werden.

Funktionsumfang

frei konfigurierbare Asset-Kategorien, Felder und Statuswerte
Assetlisten, Detailansichten, Historie, Ausgabe und Rückgabe
Excel-Import und -Export, Sammeländerungen, Zusammenführen und Baumansicht
Hardware- und Softwareinventur
Jobdefinitionen und Jobausführung mit Status, Callback, Wiederholung und Protokollen
lokale Benutzerverwaltung und optionale LDAP-Anmeldung
geschütztes lokales Notfallkonto auch bei aktiviertem LDAP
Rollen, Sichtbarkeitsregeln, Übersetzungen, Darkmode und anpassbare Darstellung
integrierte Sicherungs- und Wiederherstellungsfunktionen
optionale MeshCentral-Anbindung über die MeshCtrl-Kommandozeilenschnittstelle

MeshCentral-Integration

Die Integration ist optional. AssetManager verwendet MeshCtrl für unterstützte Geräteabfragen und Remote-Aufträge. Es erfolgt kein direkter Zugriff auf die MeshCentral-Datenbank. MeshCentral und MeshCtrl sind eigenständige Drittprojekte und nicht Bestandteil dieses Repositorys; sie werden beim Docker-Build als Abhängigkeit installiert.

Voraussetzungen

Docker Engine mit Docker Compose
ein für den Server geeigneter DNS-Name und HTTPS-Reverse-Proxy werden für produktive Installationen empfohlen
optional eine erreichbare MeshCentral-Instanz
optional LDAP/Active Directory

Installation

cp .env.example .env

Ändere in .env mindestens:

POSTGRES_PASSWORD=CHANGE_ME
SESSION_SECRET=CHANGE_ME_LONG_RANDOM
LOCAL_ADMIN_USERNAME=emergency-admin
LOCAL_ADMIN_PASSWORD=CHANGE_ME_MIN_12_CHARS

Danach:

docker compose up -d --build

Standardmäßig ist die Anwendung unter Port 8088 erreichbar.

Persistente Daten

Die Laufzeitdaten werden über Bind-Mounts unter data/ gespeichert:

data/
├── config/       Anwendungskonfiguration
├── postgres/     PostgreSQL-Datenbank
├── uploads/      hochgeladene Dateien
├── logs/         Protokolle und Diagnosedaten
├── backups/      Anwendungssicherungen
└── scripts/      bereitgestellte Skripte

Diese Inhalte sowie .env enthalten möglicherweise Zugangsdaten oder personenbezogene beziehungsweise betriebliche Daten und dürfen nicht in ein öffentliches Repository aufgenommen werden.

Aktualisierung

Vor einer Aktualisierung immer .env und den gesamten Ordner data/ sichern. Danach den neuen Quellstand über den bestehenden Projektordner kopieren und ausführen:

docker compose down
docker compose up -d --build
docker compose logs --tail=100 -f

Öffentlichen Quellstand erzeugen

Der Exporter erstellt ein bereinigtes ZIP mit genau einem Hauptordner assetmanager/:

python tools/create_github_source.py

Vor dem Export prüft das Skript unter anderem Versionen, Lizenzangaben, vertrauliche Laufzeitdateien und unerwünschte Produktvergleiche.

Prüfungen

python tools/check_public_release.py
python tools/check_translations.py
python tools/validate_release.py

Drittkomponenten

Die direkten Abhängigkeiten und ihre Lizenztypen sind in THIRD_PARTY_NOTICES.md aufgeführt. Beim Docker-Build werden zusätzlich die Lizenzdateien der tatsächlich installierten Python- und Node.js-Pakete unter /app/THIRD_PARTY_LICENSES/ gesammelt.

Mitwirken

Beiträge und Forks sind willkommen. Hinweise zur Einreichung stehen in CONTRIBUTING.md. Eine Einreichung ist ein Vorschlag; es besteht kein Anspruch auf Aufnahme in das offizielle Projekt.

Sicherheit

Sicherheitsprobleme bitte nicht mit vertraulichen Details in einer öffentlichen Issue melden. Siehe SECURITY.md.

Lizenz

Lizenziert unter der Apache License, Version 2.0. Der vollständige Lizenztext befindet sich in LICENSE.txt.