Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/admin/getting-started/kubernetes.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,5 +3,5 @@ sidebar_position: 8
id: kubernetes
title: Kubernetes
description: Kubernetes
draft: false
draft: true
---
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
---
sidebar_position: 2
id: app-tokens
title: App Tokens
description: App Tokens in OpenCLoud
draft: false
---

# App-Tokens

App-Tokens ermöglichen es dir, externe Apps und Dienste (z. B. WebDAV-Clients) sicher mit OpenCloud zu verbinden – ohne dein Hauptpasswort verwenden zu müssen.

## App-Token erstellen

- Gehe in deinen OpenCloud-Kontoeinstellungen zum Bereich „App-Tokens“.
- Klicke auf „+ Neu“, um ein neues Token zu erstellen.
- Gib dem Token einen Namen (z. B. „WebDAV-Client“).
- Wähle ein Ablaufdatum für zusätzliche Sicherheit.
- Klicke auf „Erstellen“.

<img src={require("./img/app-tokens/create.png").default} alt="App-Token erstellen" width="400"/>

## App-Token kopieren

- Nach der Erstellung wird das Token nur einmal angezeigt.
- Kopiere es sofort und speichere es an einem sicheren Ort.

<img src={require("./img/app-tokens/copy-token.png").default} alt="Token kopieren" width="400"/>

:::note
Wenn du das Token verlierst, musst du es löschen und ein neues erstellen.
:::

## App-Token verwenden

Du kannst das Token jetzt anstelle deines Passworts nutzen, z. B. für:

- WebDAV
- Externe Anwendungen
- Dienste von Drittanbietern

## App-Token löschen

Wenn ein Token nicht mehr benötigt wird:

- Gehe zurück in den Bereich „App-Tokens“.
- Klicke auf das Papierkorb-Symbol neben dem Token, um es zu entfernen.

So stellst du sicher, dass ungenutzte Tokens nicht missbraucht werden können.

:::note
Nutze App-Tokens für mehr Sicherheit und Kontrolle bei der Verbindung externer Dienste.
:::
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -2,54 +2,48 @@
sidebar_position: 1
id: settings
title: Einstellungen
description: Einstellungen
draft: false
---

## Überblick über den Admin-Bereich
# Überblick über den Admin-Bereich

Im Admin-Bereich von OpenCloud haben Sie umfangreiche Verwaltungsoptionen für Ihre Organisation. Hier sind die wichtigsten Bereiche:
<img src={require("./img/settings/admin-einstellungen.png").default} alt="Admin settings" width="400"/>

---

### Allgemein
## Allgemein

- **Übersicht über Ausgabe und Version**
Sie können Informationen über die **Edition** und **Version** Ihrer OpenCloud anzeigen.
- Übersicht über Ausgabe und Version
Sie können Informationen über die Edition und Version Ihrer OpenCloud anzeigen.
<img src={require("./img/settings/allgemein.png").default} alt="Admin general" width="1920"/>

---
## Benutzer

### Benutzer

- **Übersicht der Benutzer**
Hier haben Sie einen Überblick über alle **Benutzer** von Ihre OpenCloud.
- **Benutzer verwalten**:
- Übersicht der Benutzer
Hier haben Sie einen Überblick über alle Benutzer von Ihre OpenCloud.
- Benutzer verwalten:
Abhängig von Ihren Benutzerverwaltungseinstellungen können Sie: - Benutzer erstellen oder löschen - Benutzer bearbeiten (z.B. Rechte oder Einstellungen ändern) - Quota (Speicherplatz) von Benutzern ändern - Benutzer in Gruppen hinzufügen oder entfernen - Allow or prohibit logins (for individual users)
<img src={require("./img/settings/personen.png").default} alt="Admin users" width="1920"/>

---

### Gruppen
## Gruppen

- **Übersicht der Gruppen**
Hier können Sie die vorhandenen **Gruppen** Ihrer OpenCloud anzeigen.
- **Gruppen verwalten**:
Sie können **lokale Gruppen erstellen, bearbeiten oder löschen** und Mitglieder hinzufügen oder entfernen.
- **Importierte Gruppen**: Externe Gruppen, die über ein externes Benutzerverwaltungssystem importiert wurden, können hier **nicht bearbeitet werden**. Diese Gruppen sind mit einem **Sperrsymbol**
- Übersicht der Gruppen
Hier können Sie die vorhandenen Gruppen Ihrer OpenCloud anzeigen.
- Gruppen verwalten:
Sie können lokale Gruppen erstellen, bearbeiten oder löschen und Mitglieder hinzufügen oder entfernen.
- Importierte Gruppen: Externe Gruppen, die über ein externes Benutzerverwaltungssystem importiert wurden, können hier nicht bearbeitet werden. Diese Gruppen sind mit einem Sperrsymbol
gekennzeichnet, um anzuzeigen, dass sie gesperrt sind.
<img src={require("./img/settings/gruppen.png").default} alt="Admin groups" width="1920"/>

---

### Spaces
## Spaces

- **Übersicht der Spaces**
Hier sehen Sie alle vorhandenen **Spaces** in Ihrer OpenCloud.
- **Space Management**: Als Administrator haben Sie volle Rechte auf: **Bearbeiten**
- **Deaktivieren oder aktivieren**
- **Löschen**
- Übersicht der Spaces
Hier sehen Sie alle vorhandenen Spaces in Ihrer OpenCloud.
- Space Management: Als Administrator haben Sie volle Rechte auf: Bearbeiten
- Deaktivieren oder aktivieren
- Löschen
<img src={require("./img/settings/spaces.png").default} alt="Admin spaces" width="1920"/>

---

**Diese Admin-Einstellungen ermöglichen es Ihnen Um Ihre OpenCloud-Umgebung umfassend zu verwalten und anzupassen!**
:::note
Diese Admin-Einstellungen ermöglichen es Ihnen Um Ihre OpenCloud-Umgebung umfassend zu verwalten und anzupassen!
:::
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
---
sidebar_position: 3
id: web-dav
title: WebDAV
description: Verbindung zu einem Space via WebDAV
draft: false
---

# Verbindung zu einem Space via WebDAV herstellen

Mit WebDAV kannst du OpenCloud-Spaces als Netzlaufwerke auf deinem Gerät einbinden und deine Dateien direkt über den Dateimanager verwalten – ganz ohne Browser.

## Voraussetzungen

- Ein gültiges OpenCloud-Konto mit aktivierter WebDAV-Information in den Einstellungen
- Zugriff auf einen Space in OpenCloud
- Ein WebDAV-Client (z. B. integrierte Unterstützung des Betriebssystems oder [Mountain Duck](https://mountainduck.io/))
- (Optional, aber empfohlen) Ein App-Token
→ [So erstellst du ein App-Token](./app-tokens.md)

## Schritt-für-Schritt-Anleitung

### WebDAV-Informationen in der Oberfläche aktivieren

Um die WebDAV-Informationen für deine Spaces anzuzeigen:

- Gehe zu den Kontoeinstellungen
- Aktiviere „WebDAV-Info in der Detailansicht anzeigen“

<img src={require("./img/webdav/preferences.png").default} alt="WebDAV-Info aktivieren" width="1920"/>

### App-Token erstellen (falls erforderlich)

Einige WebDAV-Clients (insbesondere solche ohne OIDC-Unterstützung wie Mountain Duck) benötigen ein App-Token zur Authentifizierung.

:::note
Wir empfehlen aus Sicherheitsgründen die Verwendung eines App-Tokens anstelle deines Passworts.
:::

- Gehe zu Einstellungen > App-Tokens
- Klicke auf „+ Neu“, gib einen Namen ein und wähle ein Ablaufdatum
- Kopiere den Token sofort – er wird nur einmal angezeigt
→ [Siehe App-Token-Anleitung](./app-tokens.md)

### WebDAV-URL abrufen

Öffne das Info-Panel deines Spaces in der OpenCloud-Weboberfläche.

Du findest dort einen Abschnitt „WebDAV“ – kopiere die vollständige URL. Diese sieht beispielsweise so aus:

`https://cloud.example.de/remote.php/dav/spaces/12345678-abcd-efgh-ijkl-987654321000/`

<img src={require("./img/webdav/webdav-url.png").default} alt="WebDAV-URL" width="1920"/>

### Verbindung via WebDAV herstellen

Stelle nun die Verbindung zu deinem Gerät über die WebDAV-URL her:

- Benutzername: dein OpenCloud-Benutzername
- Passwort: dein App-Token (oder Passwort, falls erlaubt)

Du kannst je nach Betriebssystem unterschiedliche Clients verwenden:

## Windows

- Öffne den Datei-Explorer → Klicke auf „Dieser PC“ → Wähle „Netzlaufwerk verbinden“
- Gib die WebDAV-URL ein
- Authentifiziere dich mit Benutzername und App-Token

## macOS

- Wähle im Finder „Gehe zu“ > „Mit Server verbinden…“
- Gib die WebDAV-URL ein
- Melde dich mit deinen Zugangsdaten oder dem App-Token an

## Linux

- Nutze die Funktion „Mit Server verbinden“ deines Dateimanagers
- Format der URL:
`davs://cloud.beispiel.de/remote.php/dav/spaces/<SPACE-ID>/`

:::note
Nach erfolgreicher Verbindung verhält sich dein Space wie ein normaler Ordner.
:::

:::note

- Wenn dein WebDAV-Client OIDC unterstützt, ist ein App-Token eventuell nicht erforderlich
- Verwende immer `https://` für einen sicheren Zugriff
- App-Tokens können jederzeit in den Kontoeinstellungen widerrufen werden

:::