ralf/freecad-plm
1
0
Fork 0
Code Issues 2 Pull requests Releases Packages 1 Wiki Activity Actions
Page: Erster Start und Verwaltung
Pages
Erster Start und Verwaltung Fertigung und 3MF Dateien FreeCAD Addon Handbuch Home Installation mit Docker Compose Konzepte Projektstände und Import Revisionen Exporte und Vergleich Troubleshooting Web UI Benutzung
1 Erster Start und Verwaltung
Ralf Warmuth edited this page 2026-07-12 20:43:49 +00:00
Table of Contents

Erster Start und Verwaltung

Nach der Installation muss FreeCAD-PLM einmal initial eingerichtet werden. Danach findet die normale Verwaltung in der Web-Oberfläche unter Verwaltung statt.

Rollen initial anlegen

Im Container:

docker compose -f docker-compose.image.yml exec web python manage.py setup_plm_roles

Dadurch werden die PLM-Gruppen vorbereitet:

  • reader,
  • editor,
  • admin.

Ersten Superuser anlegen

docker compose -f docker-compose.image.yml exec web python manage.py createsuperuser

Dieser Benutzer kann sich in der normalen PLM-Oberfläche und im Django-Admin anmelden.

Anmeldung

Die normale Anmeldung liegt unter:

/login/

Nach der Anmeldung landest du im PLM-Web-UI. Der Django-Admin unter /admin/ ist nur die technische Fallback-Verwaltung.

Benutzerverwaltung im Web-UI

Als Admin siehst du in der linken Navigation den Bereich Verwaltung.

Dort kannst du:

  • Benutzer anlegen,
  • Benutzer bearbeiten,
  • Benutzer aktivieren oder deaktivieren,
  • Rollen setzen,
  • Passwörter neu setzen,
  • API-Tokens anlegen, bearbeiten und widerrufen. Die API-Token werden bspw. im FreeCAD-Addon verwendet.

Rollen im Alltag

reader eignet sich für Personen, die nur nachsehen und Dateien herunterladen sollen.

editor eignet sich für Konstrukteure, die neue Teile, Baugruppen und Revisionen anlegen dürfen.

admin eignet sich für Betreiber oder Projektverantwortliche. Admins dürfen zusätzlich Projekte bearbeiten, Benutzer verwalten, Revisionen freigeben, obsolet markieren und Projekte löschen.

API-Tokens

API-Tokens sind für Maschinenzugriffe gedacht, insbesondere später für das FreeCAD-Addon. Sie ersetzen keine normale Browser-Anmeldung.

Beim Anlegen eines Tokens wird der Klartext nur einmal angezeigt. Danach ist nur noch der Prefix sichtbar. Wenn ein Token verloren geht, lege einen neuen an und widerrufe den alten.

Token-Presets:

  • Nur Lesen: lesender Zugriff,
  • Addon Standard: Lesen, Schreiben und Checkout,
  • Admin/Vollzugriff: volle API-Rechte.

Admin/Vollzugriff sollte nur für Benutzer mit Admin-Rolle oder Superuser verwendet werden.

Hintergrundjobs beobachten

In der linken Seitenleiste erscheint für angemeldete Benutzer der Bereich Hintergrundjobs, sobald eigene Jobs laufen oder anstehen. Dort erkennst du, ob Analyse-, Export- oder PNG-Jobs noch warten, laufen, erfolgreich waren oder fehlgeschlagen sind.

Wenn Jobs dauerhaft nicht weiterlaufen, prüfe den Worker-Container. Siehe Troubleshooting.

FreeCAD-PLM