# IT

Directus, BookStack, Nextcloud: Hier findest du Anleitungen für all unsere Software

# Startpunkt für Mitglieder

Diese Seite soll einen kleinen Überblick über unsere verschiedenen Anwendungen bieten. Diese Anwendungen sind:

<table id="bkmrk-namelinkanleitungenn" style="border-style: none;"><colgroup><col></col><col></col><col></col></colgroup><tbody><tr><td>****Name****

</td><td>****Link****

</td><td>****Anleitungen****

</td></tr><tr><td>Nextcloud

</td><td>[https://cloud.swablab.de](https://cloud.swablab.de)

</td><td>[Dateien (Nextcloud)](https://wiki.swablab.de/books/it/chapter/dateien-nextcloud "Dateien (Nextcloud)")

</td></tr><tr><td>Wiki

</td><td>[https://wiki.swablab.de](https://wiki.swablab.de)

</td><td>[Wiki (BookStack)](https://wiki.swablab.de/books/it/chapter/wiki-bookstack "Wiki (BookStack)")

</td></tr><tr><td>Directus

</td><td>[https://directus.swablab.de](https://directus.swablab.de)

</td><td>[Directus](https://wiki.swablab.de/books/it/chapter/directus "Directus")

</td></tr><tr><td>Forgejo

</td><td>[https://git.swablab.de](https://git.swablab.de)

</td><td>[Git (Forgejo)](https://wiki.swablab.de/books/it/chapter/git-forgejo "Git (Forgejo)")

</td></tr><tr><td>Zitadel

</td><td>[https://login.swablab.de](https://login.swablab.de)

</td><td>[Login (Zitadel)](https://wiki.swablab.de/books/it/chapter/login-zitadel "Login (Zitadel)")

</td></tr><tr><td>Discord

</td><td>[https://swablab.de/discord](https://swablab.de/discord)

</td><td></td></tr></tbody></table>

<span style="white-space: pre-wrap;">Um direkt zu unserer Todo Liste zu gelangen, kannst du folgenden Link benutzen: </span>[Todo](https://directus.swablab.de/admin/content/tasks_general "Todo")

# Login (Zitadel)

# Anmeldung an Zitadel

1. Benutzername eingeben (Vorname + erster Buchstabe des Nachnamens)  
    [![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-02/scaled-1680-/SUKOpHM6pqmWrWMO-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-02/SUKOpHM6pqmWrWMO-image.png)
2. Passwort eingeben  
    [![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-02/scaled-1680-/Fmw2khenIpbHYD4K-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-02/Fmw2khenIpbHYD4K-image.png)

# Passwort vergessen

1. [https://login.swablab.de](https://login.swablab.de)<span style="white-space: pre-wrap;"> aufrufen und Benutzernamen eingeben (Vorname + erster Buchstabe des Nachnamens):</span>  
    [![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-02/scaled-1680-/dI50pav322lmFnjQ-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-02/dI50pav322lmFnjQ-image.png)
2. **reset password**<span style="white-space: pre-wrap;"> anklicken</span>  
    [![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-02/scaled-1680-/Irx3D1VAHbeYvH1T-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-02/Irx3D1VAHbeYvH1T-image.png)
3. den Anweisungen der Passwort zurücksetzen E-Mail folgen

# Passwort ändern

<span style="white-space: pre-wrap;">An der Zitadel Console unter </span>[https://login.swablab.de](https://login.swablab.de)<span style="white-space: pre-wrap;"> anmelden und folgende Schritte durchführen:</span>

1. **Password and Security**<span style="white-space: pre-wrap;"> auswählen:</span>  
    [![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-02/scaled-1680-/6qgSplYTFXcJfA9V-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-02/6qgSplYTFXcJfA9V-image.png)
2. **Edit Password**<span style="white-space: pre-wrap;"> anklicken:</span>  
    [![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-02/scaled-1680-/eLZj02TaNTDqTU2O-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-02/eLZj02TaNTDqTU2O-image.png)
3. Aktuelles Passwort und neues Passwort 2 mal eingeben:  
    [![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-02/scaled-1680-/VE1L6luHGqnKxV4E-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-02/VE1L6luHGqnKxV4E-image.png)

# Wiki (BookStack)

# Struktur

In Bookstack gibt es mehrere Ebenen, in denen Wiki-Einträge strukturiert werden. Da diese Software eigentlich für Bücher gedacht ist, man sich das aber für eine Werkstatt schwerer vorstellen kann, wird die Struktur im Folgenden am Beispiel eines Ringordners beschrieben.

<span style="white-space: pre-wrap;">Ein </span>****Buch****<span style="white-space: pre-wrap;"> ist wie der Ringordner. Hier werden sehr groß gefasste Themengebiete definiert, z.B. IT oder Verein. Ein </span>****Kapitel****<span style="white-space: pre-wrap;"> ist ein Register bzw. Trennblätter. Man kann sie optional verwenden, um den Ordner in Untergruppen aufzuteilen. Eine </span>****Seite****<span style="white-space: pre-wrap;"> ist wie eine Klarsichthülle. Hier drin ist der Inhalt mit Bildern und dazugehörigem Material. Als letztes Element gäbe es noch das </span>****Regal,****<span style="white-space: pre-wrap;"> welches wie ein echtes Regal mehrere Bücher enthält, allerdings haben wir nicht so viele Bücher, dass es sich lohnt.</span>

Um zu wissen, welcher Inhalt in welches Buch gehört, haben alle Bücher eine kurze Beschreibung. Wenn du dir unsicher bist, dann kannst du auch jemanden Fragen, notfalls kann man die Seite auch später verschieben.

****Bitte beachte:****<span style="white-space: pre-wrap;"> Alle Inhalte sind standardmäßig öffentlich. Daher dürfen keine Passwörter oder sensible Daten hier gespeichert werden. Achte zudem auf eine einigermaßen schöne Form und gutes Deutsch.</span>

# Seiten anlegen und bearbeiten

<span style="white-space: pre-wrap;">Wenn du im Wiki neuen Inhalt erstellen oder anpassen möchtest, kannst du das gerne jederzeit tun. Hierfür musst du im richtigen Buch oder Kapitel sein, dann kannst du rechts über die Aktionen (oder auf dem Handy im Tab </span>`<span class="editor-theme-code">Info</span>`) neue Seiten oder Kapitel anlegen. Wenn du auf einer Seite bist, kannst du dort die Seite bearbeiten, kopieren oder verschieben.

### Text bearbeiten

Der Editor bietet ähnliche Funktionen wie Word, nur etwas simpler. Im oberen Bereich kann man den Titel ändern, darunter befindet sich die Aktionsleiste. Hier kannst du Überschriften einfügen, den Text formatieren, einfärben und ausrichten sowie Listen, Links, Tabellen, Bilder und sogar Diagramme und Videos einfügen.

[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/7WN31HQwioaAMN3b-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/7WN31HQwioaAMN3b-image.png)

<span style="white-space: pre-wrap;">Generell wird empfohlen, mittlere Überschriften zu verwenden, wichtige Worte </span>****Fett****<span style="white-space: pre-wrap;"> zu schreiben und Code oder Anweisungen statt in Anführungszeichen in </span>`<span class="editor-theme-code">Inline-Blöcken</span>`<span style="white-space: pre-wrap;"> zu schreiben. Vor allem gilt: Lieber eine schlichte Formatierung, der Inhalt ist relevant!</span>

### Bilder hinzufügen

<span style="white-space: pre-wrap;">Bilder lassen sich am besten per </span>`<span class="editor-theme-code">Strg+V</span>`<span style="white-space: pre-wrap;"> oder Drag&amp;Drop hinzufügen. Ansonsten kannst du das auch per Knopf hochladen und einfügen.</span>

[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/qOWLSGhd6QbAhOSk-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/qOWLSGhd6QbAhOSk-image.png)[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/a1DVogFpgTJYq9Vp-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/a1DVogFpgTJYq9Vp-image.png)

Das Verschieben von Bildern ist nicht möglich, daher wird empfohlen das Bild zu löschen und neu einzufügen. Generell verhält sich der Editor mit Bildern manchmal komisch, im Zweifel das Dokument schließen und wieder öffnen.

Bitte bei Bildern immer auf die Dateigröße achten, das kostet alles Speicherplatz!

### Anhänge hinzufügen

Anhänge lassen sich rechts neben dem Dokument mit der Büroklammer hochladen. Hier wie auch bei den Bildern auf die Dateigröße achten!

[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/tJIqtNwfRxyVfjjR-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/tJIqtNwfRxyVfjjR-image.png)

Diese sind nach dem Speichern links oben zu sehen.

[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/GBcseSvzbFI5Cltd-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/GBcseSvzbFI5Cltd-image.png)

# Directus

# Todo Liste

<span style="white-space: pre-wrap;">Unsere Todo Liste findest du im </span>[Directus](https://directus.swablab.de)<span style="white-space: pre-wrap;"> ganz oben, oder unter folgendem Link: </span>[https://directus.swablab.de/admin/content/tasks\_general](https://directus.swablab.de/admin/content/tasks_general)<span style="white-space: pre-wrap;"></span>

[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/lz80CZXnrYbxvz0V-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/lz80CZXnrYbxvz0V-image.png)

Wenn diese bei dir anders aussieht, dann musst du das Layout rechts in der Seitenleiste ändern. Wir haben ein eigenes Layout, weil dieses deutlich übersichtlicher ist und auch auf dem Handy funktioniert:

[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/iiigqVoXvAzwtJwF-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/iiigqVoXvAzwtJwF-image.png)

### Erklärung der Icons

<table id="bkmrk-die-icons-am-anfang-" style="border-style: hidden;"><colgroup><col style="width: 54px;"></col><col style="width: 805px;"></col></colgroup><tbody><tr style="height: 10px;"><td>[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/GRFznLXrYgL8L2ey-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/GRFznLXrYgL8L2ey-image.png)

</td><td>Die Icons am Anfang ist die Kategorie des Todos. Hier kannst du einfach unterscheiden, ob es z.B. um Holz oder IT geht. Wenn das Icon orange ist, dann hat das Todo eine hohe Priorität, wenn es grau ist eine niedrige.

</td></tr><tr><td>[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/sczkavhF5IOlR4hL-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/sczkavhF5IOlR4hL-image.png)

</td><td>Diese Aufgabe ist noch niemandem zugewiesen

</td></tr><tr style="height: 10px;"><td>[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/guBg4qET1cBmWcfN-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/guBg4qET1cBmWcfN-image.png)

</td><td>Diese Aufgabe ist dir zugewiesen

</td></tr></tbody></table>

### Neues Todo anlegen

Jeder darf jederzeit Todos erstellen oder bearbeiten. Klick hierfür einfach auf das Icon oben rechts:

[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/0OiRJ2553CVrT1ZL-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/0OiRJ2553CVrT1ZL-image.png)

# Ausleihliste

<span style="white-space: pre-wrap;">Du kannst gerne Gegenstände aus dem Verein ausleihen. Damit wir nachvollziehen können, wo sich unsere Inventar-Gegenstände gerade befinden, gibt es eine Ausleihliste. Diese befindet sich im Directus unter </span>[https://directus.swablab.de/admin/content/lendings](https://directus.swablab.de/admin/content/lendings).

[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/t1vB4IWWDl5Sj8BQ-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/t1vB4IWWDl5Sj8BQ-image.png)

<span style="white-space: pre-wrap;">Wenn der Gegenstand eine </span>****Inventar-Nummer****<span style="white-space: pre-wrap;"> hat, dann kannst du ihn direkt aus der Liste auswählen:</span>

[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/43KTUHqZpt4SVtc2-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/43KTUHqZpt4SVtc2-image.png)

[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/ZXutUoUq0KQbl6vF-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/ZXutUoUq0KQbl6vF-image.png)

<span style="white-space: pre-wrap;">Falls </span>****nicht****<span style="white-space: pre-wrap;"> dann kannst du den Gegenstand auch einfach im Feld daneben beschreiben</span>

[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/RwoKeg8PUj2Yh0jt-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/RwoKeg8PUj2Yh0jt-image.png)

<span style="white-space: pre-wrap;">Dann trage in </span>****Ausgeliehen am****<span style="white-space: pre-wrap;"> das aktuelle Datum und bei </span>****Name des Ausleihenden****<span style="white-space: pre-wrap;"> deinen Vor- und Nachnamen ein. Als </span>****Kontakt****<span style="white-space: pre-wrap;"> kannst du einfach deine aktuelle E-Mail Adresse eintragen, diese wird nur benötigt wenn wir dich sonst nicht mehr erreichen können.</span>

<span style="white-space: pre-wrap;">Wenn du den Gegenstand zurückgibst, denk dran das </span>****Zurückgegeben am****<span style="white-space: pre-wrap;"> Datum einzutragen.</span>

# Dateien (Nextcloud)

# Dateien

Dokumentation sind im Wiki, Quellcode im Git und alle anderen Dateien befinden sich in Nextcloud. Hier findest du Bilder und Videos von Veranstaltungen, 3D-Druck Objekte, PDFs und vieles weiteres.

<span style="white-space: pre-wrap;">Auf den Ordner </span>****allgemein****<span style="white-space: pre-wrap;"> hat jedes Mitglied vollen Zugriff und darf Dateien beliebig hoch- und herunterladen. Bitte beachte, dass die Dateien bei uns auf dem Server gespeichert werden, also achte bitte auf die Dateigröße und sorge dafür, dass nicht mehr benötigtes gelöscht wird.</span>

### Historie

Hier sind Dateien abgelegt, die entweder einem speziellen Ereignis oder Datum zugewiesen werden oder bei denen das Datum relevant ist. Beispiele:

- Bilder oder Videos von Events wie dem Tag der offenen Tür 2023
- Vorbereitungen, Flyer und Bilder für das Sommerferienprogramm 2024
- Bilder vom Zustand einer Maschine vor und nach einem Umbau
- Pressematerial für einen Zeitungsartikel
- Doku zu erhaltenen Gegenständen bei einem Sponsoring

### Projekte

Hier sind Dateien die weniger einem Datum sondern mehr einem Projekt oder einer Idee zugeordnet werden. Beispiele:

- STL-Dateien für 3D-Druck Projekte
- PDFs der Bedienungsanleitung einer Maschine
- Ideen und Konzepte für neue Projekte

# Kalender

Im Kalender finden sich alle Termine unseres Vereins wie Events und sonstige Termine. Auf den Kalender kann jedes Mitglied im Nextcloud zugreifen. Der Kalender wird vom Vorstand gepflegt. Falls Termine ausfallen oder hinzu kommen, kann dies im Kalender nachgeschaut werden.

### Kalender am Handy hinzufügen (Android)

1. Lade dir die DAVx<sup><span class="editor-theme-superscript">5</span></sup><span style="white-space: pre-wrap;"> App aus dem Playstore herunter (</span>[https://www.davx5.com/](https://www.davx5.com/)).
2. <span style="white-space: pre-wrap;">Füge einen neuen Account mit </span>`<span class="editor-theme-code">+</span>`<span style="white-space: pre-wrap;"> hinzu</span>
    1. Provider-spezifische Anmeldung
    2. Nextcloud
    3. <span style="white-space: pre-wrap;">Server-Instanz </span>`<span class="editor-theme-code">cloud.swablab.de</span>`
3. Melde dich mit deinem swablab Benutzernamen und Passwort in der App an.
4. <span style="white-space: pre-wrap;">Aktiviere im Reiter </span>`<span class="editor-theme-code">CALDAV</span>`<span style="white-space: pre-wrap;"> die Kalender, welche du auf dein Smartphone synchronisieren möchtest.</span>
5. Gehe in die Kalender-App deiner Wahl und blende die synchronisierten Kalender ein.

# Git (Forgejo)

# Repositories

Im Forgejo haben wir aktuell zwei Organisationen für Repositories:

- ****swablab****<span style="white-space: pre-wrap;"> ist die offizielle Organisation und wird vom Vorstand gepflegt. Hier hat niemand direkten Schreibzugriff, Änderungen werden über Pull Requests gemacht.</span>
- ****projects****<span style="white-space: pre-wrap;"> ist für Projekte von Mitgliedern. Hier kann jeder sein eigenes Repository erstellen und verwalten.</span>

Repositories sind grundsätzlich öffentlich und können ohne Anmeldung auch von Nicht-Mitgliedern eingesehen werden. Genau wie beim Wiki wollen wir auch im Git jedem ermöglichen, aus unseren Projekten zu lernen. Trotzdem steht jedem frei, das Repo als Privat zu konfigurieren, z.B. wenn es nicht funktioniert oder noch nicht fertig ist.

### Neues Repository anlegen

<span style="white-space: pre-wrap;">Um ein neues Repo anzulegen, kannst du auf die </span>****project****<span style="white-space: pre-wrap;"> Organisation gehen und auf </span>****New Repository****<span style="white-space: pre-wrap;"> klicken:</span>

[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/zMnuSQeFbBwWgh34-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/zMnuSQeFbBwWgh34-image.png)

<span style="white-space: pre-wrap;">Es wird automatisch der richtige Owner ausgewählt. Du musst nur noch einen guten Namen geben (alles klein und mit - getrennt). Beachte, dass das Repository standardmäßig öffentlich ist und ohne Anmeldung eingesehen werden kann. Wenn du das nicht willst, musst du den Haken </span>`<span class="editor-theme-code">Make repository private</span>`<span style="white-space: pre-wrap;"> ankreuzen.</span>

[![image.png](https://wiki.swablab.de/uploads/images/gallery/2025-03/scaled-1680-/e5FKhq56qi5LGTjW-image.png)](https://wiki.swablab.de/uploads/images/gallery/2025-03/e5FKhq56qi5LGTjW-image.png)

Wie du das Repo einrichtest steht ab dann im Forgejo selbst.

# Lab

Werkstatt

# Netzwerkaufbau

Netzwerkbereich: 10.0.0.1/16

Fester IP-Bereich: 10.0.0.1 - 10.0.9.255