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
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,6 @@ draft: false

This guide walks you through setting up OpenCloud behind an external Nginx reverse proxy with Let's Encrypt certificates using `certbot certonly --webroot`.

---

## Requirements

- A public server with a static IP
Expand Down
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.
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.
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.
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,53 +2,51 @@
sidebar_position: 1
id: installation
title: Installation von OpenCloud Desktop
description: Install OpenCloud Client
draft: false
---

# 🖥️ OpenCloud Desktop installieren
# OpenCloud Desktop installieren

Der OpenCloud Desktop-Client ist für **Windows**, **macOS** und **Linux** verfügbar. Wählen Sie unten Ihr Betriebssystem aus und folgen Sie den Installationsschritten.
Der OpenCloud Desktop-Client ist für Windows, macOS und Linux verfügbar. Wählen Sie unten Ihr Betriebssystem aus und folgen Sie den Installationsschritten.

---
## Windows-Installation (Microsoft Store)

## 🪟 Windows-Installation (Microsoft Store)
- Öffnen Sie den Microsoft Store und suchen Sie nach OpenCloud Desktop oder klicken Sie auf das Bild unten.
<a href="https://apps.microsoft.com/detail/9pbx43hcmldq?mode=direct">
<img alt="Download from Microsoft Store" src="https://get.microsoft.com/images/en-us%20dark.svg" width="200"/>
</a>

1. Öffnen Sie den **Microsoft Store** und suchen Sie nach **OpenCloud Desktop** oder klicken Sie auf das Bild unten.
<a href="https://apps.microsoft.com/detail/9pbx43hcmldq?mode=direct">
<img alt="Download from Microsoft Store" src="https://get.microsoft.com/images/en-us%20dark.svg" width="200"/>
</a>
2. Klicken Sie auf **Installieren**.
3. Starten Sie die App nach der Installation über Ihr Startmenü.
- Klicken Sie auf Installieren.

> ℹ️ Die Installation über den Microsoft Store gewährleistet automatische Updates und eine nahtlose Systemintegration.
- Starten Sie die App nach der Installation über Ihr Startmenü.

---
:::note
Die Installation über den Microsoft Store gewährleistet automatische Updates und eine nahtlose Systemintegration.
:::

## 🍎 macOS-Installation (.pkg-Datei)
## macOS-Installation (.pkg-Datei)

1. Laden Sie die neueste oder gewünschte .pkg-Datei für macOS aus dem [GitHub-Repository](https://github.com/opencloud-eu/desktop/releases) herunter.
2. Doppelklicken Sie auf die heruntergeladene Datei, um das Installationsprogramm zu starten.
3. Folgen Sie den Anweisungen auf dem Bildschirm, um die Installation abzuschließen.
4. Starten Sie nach der Installation **OpenCloud Desktop** aus dem Ordner **Programme** oder dem **Launchpad**.
- Laden Sie die neueste oder gewünschte .pkg-Datei für macOS aus dem [GitHub-Repository](https://github.com/opencloud-eu/desktop/releases) herunter.

---
- Doppelklicken Sie auf die heruntergeladene Datei, um das Installationsprogramm zu starten.

## 🐧 Linux-Installation (AppImage)
- Folgen Sie den Anweisungen auf dem Bildschirm, um die Installation abzuschließen.

Wir empfehlen die Verwendung von **AppImageLauncher**, um AppImages bequem zu verwalten und eine ordnungsgemäße Systemintegration zu gewährleisten.
- Starten Sie nach der Installation OpenCloud Desktop aus dem Ordner Programme oder dem Launchpad.

### Schritt 1: AppImage herunterladen
## Linux-Installation (AppImage)

Laden Sie die neueste oder gewünschte .AppImage-Version von OpenCloud Desktop aus dem [GitHub-Repository](https://github.com/opencloud-eu/desktop/releases) herunter.
Wir empfehlen die Verwendung von AppImageLauncher, um AppImages bequem zu verwalten und eine ordnungsgemäße Systemintegration zu gewährleisten.

### Schritt 2: AppImageLauncher installieren
- Laden Sie das neueste oder gewünschte `.AppImage` von OpenCloud Desktop aus dem [GitHub-Repository](https://github.com/opencloud-eu/desktop/releases) herunter.

AppImageLauncher integriert AppImages automatisch in Ihr Systemmenü.

👉 Folgen Sie den Installationsanweisungen hier:
[AppImageLauncher Installationsanleitung](https://github.com/TheAssassin/AppImageLauncher#installation)

### Schritt 3: OpenCloud starten

- Klicken Sie mit der rechten Maustaste auf die heruntergeladene Datei „OpenCloud.AppImage“ und wählen Sie „Mit AppImageLauncher öffnen“.
- AppImageLauncher integriert AppImages automatisch in Ihr Systemmenü.
- Klicken Sie mit der rechten Maustaste auf die heruntergeladene Datei `OpenCloud.AppImage` und wählen Sie `Mit AppImageLauncher öffnen`.
- Bestätigen Sie die Aufforderung von AppImageLauncher, die App zu integrieren.
- OpenCloud Desktop ist nun wie jede andere App in Ihrem Anwendungsmenü verfügbar.

:::note
Folgen Sie den Installationsanweisungen hier:
[AppImageLauncher Installationsanleitung](https://github.com/TheAssassin/AppImageLauncher#installation)
:::
Original file line number Diff line number Diff line change
Expand Up @@ -2,56 +2,60 @@
sidebar_position: 5
id: logging
title: Logfiles sammeln
description: Logfiles sammeln in OpenCloud
draft: false
---

# Protokollierung in einem temporären Verzeichnis in OpenCloud Desktop

Wenn Sie Protokolle für die Fehlersuche erstellen müssen, gehen Sie wie folgt vor:

## 1. Öffnen Sie OpenCloud Desktop
## Öffnen Sie die Log-Einstellungen

## 2. Öffnen Sie die Log-Einstellungen
- Klicken Sie auf Einstellungen → Erweitert → Log-Einstellungen

Klicken Sie auf **Einstellungen → Erweitert → Log-Einstellungen**
<img src={require("./img/logging/logging-access.png").default} alt="logging access" width="400"/>

<!--- <img src={require("./img/logging/logging-access.png").default} alt="logging access" width="400"/>--->
## Aktivieren Sie die Protokollierung

## 3. Aktivieren Sie die Protokollierung
- Aktivieren Sie im Fenster Protokollausgabe das Kontrollkästchen Protokollierung in temporärem Ordner aktivieren.
- Um dem Support-Team und den Entwicklern zu helfen, ist es hilfreich, das Log Http traffic zu aktivieren

- Aktivieren Sie im Fenster **Protokollausgabe** das Kontrollkästchen **Protokollierung in temporärem Ordner aktivieren**.
- Um dem Support-Team und den Entwicklern zu helfen, ist es hilfreich, das **Log Http traffic** zu aktivieren
<img src={require("./img/logging/logging-enable.png").default} alt="enable logging" width="400"/>

<!--- <img src={require("./img/logging/logging-enable.png").default} alt="enable logging" width="400"/>--->
## Finden Sie die Log-Dateien

## 4. Finden Sie die Log-Dateien
- Klicken Sie auf Ordner öffnen, um auf die Protokolle zuzugreifen.

- Klicken Sie auf **Ordner öffnen**, um auf die Protokolle zuzugreifen.

<!--- <img src={require("./img/logging/logging-open-folder.png").default} alt="open logfile folder" width="400"/>--->
<img src={require("./img/logging/logging-open-folder.png").default} alt="open logfile folder" width="400"/>

- Wählen Sie die Protokolldateien für den Zeitraum aus, in dem das Problem aufgetreten ist.

<!--- <img src={require("./img/logging/logging-logfiles.png").default} alt="logfiles overview" width="400"/>--->
<img src={require("./img/logging/logging-logfiles.png").default} alt="logfiles overview" width="400"/>

:::note
Diese Protokolle können helfen, Probleme mit OpenCloud Desktop zu diagnostizieren und zu beheben.
:::

### Log Inhalt Beschreibung

`25-02-17 09:02:35:174 [ info sync.httplogger ]: REQUEST 3710cc12-7391-4793-8e89-00499dc11983 {„request“:{„body“:{„length“:0},„header“:{„accept“:„*/*“,„accept-language“:„en_DE“,„original-request-id“:„3710cc12-7391-4793-8e89-00499dc11983“,„user-agent“:"Mozilla/5. 0 (Macintosh) mirall/1.0.0-git (OpenCloud, macos-24. 3.0 ClientArchitecture: x86_64 OsArchitecture: arm64)„,“x-request-id„:“3710cc12-7391-4793-8e89-00499dc11983„},“info„:{“cached„:false,“id„:“3710cc12-7391-4793-8e89-00499dc11983„,“method„:“GET„,“url„:“https://cloud.opencloud.test/.well-known/openid-configuration"}}}`

| Log Inhalt | Beschreibung |
| ---------------------------------------- | --------------------------------------------------------------------- |
| **25-02-17 09:02:35:174** | Zeitstempel der Anfrage |
| **[ info sync.httplogger ]** | Bezeichnung der Protokollkategorie |
| **3710cc12-7391-4793-8e89-00499dc11983** | X-REQUEST-ID (wird verwendet, um Anfragen und Antworten abzugleichen) |
| **Header: { }** | Liste der HTTP-Header |
| **Data: []** | HTTP-Bodies (JSON, XML) |
| **(112ms)** | Antwortzeit (seit Absenden der Anfrage) |
| Log Inhalt | Beschreibung |
| ------------------------------------ | --------------------------------------------------------------------- |
| 25-02-17 09:02:35:174 | Zeitstempel der Anfrage |
| [ info sync.httplogger ] | Bezeichnung der Protokollkategorie |
| 3710cc12-7391-4793-8e89-00499dc11983 | X-REQUEST-ID (wird verwendet, um Anfragen und Antworten abzugleichen) |
| Header: { } | Liste der HTTP-Header |
| Data: [] | HTTP-Bodies (JSON, XML) |
| (112ms) | Antwortzeit (seit Absenden der Anfrage) |

### X-REQUEST-ID für die Fehlersuche verwenden

- Die OpenCloud-Desktop-Anwendung sendet mit jeder Anfrage einen **X-REQUEST-ID**-Header.
- Die OpenCloud-Desktop-Anwendung sendet mit jeder Anfrage einen X-REQUEST-ID-Header.
- Diese ID hilft bei der Suche nach entsprechenden Anfragen und Antworten in den Protokollen.
- Sie können Ihren Webserver so konfigurieren, dass er die **X-REQUEST-ID** zu seinen Protokollen hinzufügt, um eine tiefere Analyse zu ermöglichen.
- Sie können Ihren Webserver so konfigurieren, dass er die X-REQUEST-ID zu seinen Protokollen hinzufügt, um eine tiefere Analyse zu ermöglichen.

:::note
Diese Funktion ist nützlich für die Fehlersuche bei Synchronisationsproblemen, die Überwachung von Netzwerkaktivitäten und die Behebung von Verbindungsproblemen.
:::
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
sidebar_position: 8
id: multiple-accounts
title: Mehrere Konten einrichten
description: Nutzung von mehreren Konten in OpenCloud Desktop
draft: false
---

# Mehrere Konten in OpenCloud Desktop verwenden
Expand All @@ -10,31 +12,33 @@ Sie können mehrere Konten von verschiedenen OpenCloud-Servern mit Ihrem lokalen

## Wie man ein neues Konto hinzufügt

1. Öffnen Sie den **OpenCloud Desktop**
2. Klicken Sie auf **Konto hinzufügen**
- Öffnen Sie den OpenCloud Desktop
- Klicken Sie auf Konto hinzufügen

<!-- <img src={require("./img/multiple-accounts/multiple-accounts-add-account.png").default} alt="add accounts" width="400"/> -->
<img src={require("./img/multiple-accounts/multiple-accounts-add-account.png").default} alt="add accounts" width="400"/>

3. Folgen Sie dem [standard Einrichtungsprozess](./set-up):
- Geben Sie die Server-URL ein
- Melden Sie sich mit Ihren Anmeldedaten an
- Autorisieren Sie den Zugang
- Folgen Sie dem [standard Einrichtungsprozess](./set-up):
- Geben Sie die Server-URL ein
- Melden Sie sich mit Ihren Anmeldedaten an
- Autorisieren Sie den Zugang

## Wechseln zwischen Konten

- Nachdem Sie mehrere Konten hinzugefügt haben, werden diese in der **Kontoübersicht** im Einstellungsmenü angezeigt
- Nachdem Sie mehrere Konten hinzugefügt haben, werden diese in der Kontoübersicht im Einstellungsmenü angezeigt
- Sie können einfach zwischen ihnen wechseln, um die Synchronisierungseinstellungen für jedes Konto separat zu verwalten

<!-- <img src={require("./img/multiple-accounts/multiple-accounts-switch-accounts.png").default} alt="switch accounts" width="400"/> -->
<img src={require("./img/multiple-accounts/multiple-accounts-switch-accounts.png").default} alt="switch accounts" width="400"/>

## Wie Dateien lokal gespeichert werden

- In Ihrem **Datei-Explorer** hat jedes Konto einen eigenen Ordner
- In Ihrem Datei-Explorer hat jedes Konto einen eigenen Ordner
- Standardmäßig sind die Ordner benannt:
- **OpenCloud** (für das erste Konto)
- **OpenCloud (2)** (für das zweite Konto)
- **OpenCloud (3)** (für das dritte Konto), und so weiter
- OpenCloud (für das erste Konto)
- OpenCloud (2) (für das zweite Konto)
- OpenCloud (3) (für das dritte Konto), und so weiter

<!-- <img src={require("./img/multiple-accounts/multiple-accounts-locally.png").default} alt="multiple accounts in explorer or finder" width="400"/> -->
<img src={require("./img/multiple-accounts/multiple-accounts-locally.png").default} alt="multiple accounts in explorer or finder" width="400"/>

Diese Einrichtung stellt sicher, dass Dateien von verschiedenen Konten **organisiert bleiben und nicht vermischt werden**.
:::note
Diese Einrichtung stellt sicher, dass Dateien von verschiedenen Konten organisiert bleiben und nicht vermischt werden.
:::
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
sidebar_position: 2
id: set-up
title: Einrichten von OpenCloud Desktop
description: Einrichten von OpenCloud Desktop
draft: false
---

# Einrichten von OpenCloud Desktop
Expand All @@ -10,23 +12,23 @@ Folgen Sie diesen einfachen Schritten, um OpenCloud Desktop zu installieren und

## Eingabe der Server-URL

- Öffnen Sie **OpenCloud Desktop**.
- Öffnen Sie OpenCloud Desktop.
- Geben Sie die URL Ihrer OpenCloud-Instanz ein.
- Klicken Sie auf **"Weiter“**.
- Klicken Sie auf "Weiter“.

<!--<img src={require("./img/set-up/set-up-enter-url.png").default} alt="enter URL" width="400"/>-->
img src={require("./img/set-up/set-up-enter-url.png").default} alt="enter URL" width="400"/>

## Anmeldung über Webbrowser

- Klicken Sie auf **"Webbrowser öffnen“**, um sich automatisch anzumelden.
- Klicken Sie auf "Webbrowser öffnen“, um sich automatisch anzumelden.
- Alternativ können Sie auch die angegebene URL kopieren und manuell in Ihren Browser einfügen.

<!--<img src={require("./img/set-up/set-up-login.png").default} alt="open browser to login" width="400"/> -->
<img src={require("./img/set-up/set-up-login.png").default} alt="open browser to login" width="400"/>

## Geben Sie Ihre Anmeldedaten ein

- Geben Sie Ihren **Benutzernamen** und Ihr **Passwort** ein
- Klicken Sie auf **"Anmelden“**
- Geben Sie Ihren Benutzernamen und Ihr Passwort ein
- Klicken Sie auf "Anmelden“

<img src={require("./img/set-up/set-up-user-password.png").default} alt="enter credentials" width="400"/>

Expand All @@ -40,16 +42,14 @@ Folgen Sie diesen einfachen Schritten, um OpenCloud Desktop zu installieren und

### Optionale erweiterte Konfiguration

- Wählen Sie, ob Sie **alle Dateien** synchronisieren oder **bestimmte Ordner** auswählen möchten (dies kann später angepasst werden).
- Ändern Sie das **lokale Download-Verzeichnis**, in dem Ihre Dateien gespeichert werden sollen.
- Wählen Sie, ob Sie alle Dateien synchronisieren oder bestimmte Ordner auswählen möchten (dies kann später angepasst werden).
- Ändern Sie das lokale Download-Verzeichnis, in dem Ihre Dateien gespeichert werden sollen.

<!--<img src={require("./img/set-up/set-up-advanced-configuration.png").default} alt="finalize setup" width="400"/> -->
<img src={require("./img/set-up/set-up-advanced-configuration.png").default} alt="finalize setup" width="400"/>

Sobald Sie fertig sind, klicken Sie auf **Fertig**, um die Einrichtung abzuschließen.
Sobald Sie fertig sind, klicken Sie auf Fertig, um die Einrichtung abzuschließen.

<!-- <img src={require("./img/set-up/set-up-all-set.png").default} alt="all set" width="400"/>-->
<img src={require("./img/set-up/set-up-all-set.png").default} alt="all set" width="400"/>

## Glückwunsch

**OpenCloud Desktop** ist nun erfolgreich eingerichtet.
OpenCloud Desktop ist nun erfolgreich eingerichtet.
Sie können mit der nahtlosen Synchronisierung Ihrer Dateien zwischen Ihrem Gerät und dem OpenCloud-Server beginnen!
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
sidebar_position: 3
id: settings
title: Einstellungen
description: Ändern der Einstellungen in OpenCloud Desktop
draft: false
---

# Einstellungen in OpenCloud Desktop ändern
Expand All @@ -10,9 +12,9 @@ Sie können die Einstellungen des OpenCloud Desktop mit den folgenden Schritten

## Einstellungen öffnen

- Klicken Sie auf **"Einstellungen“** in der oberen rechten Ecke von OpenCloud Desktop
- Klicken Sie auf "Einstellungen“ in der oberen rechten Ecke von OpenCloud Desktop

<!-- <img src={require("./img/settings/settings-overview.png").default} alt="settings overview" width="400"/>-->
<img src={require("./img/settings/settings-overview.png").default} alt="settings overview" width="400"/>

## Übersicht der Einstellungen

Expand All @@ -22,7 +24,7 @@ Sie können die Einstellungen des OpenCloud Desktop mit den folgenden Schritten
- Wählen Sie, ob Desktop-Benachrichtigungen angezeigt werden sollen
- Legen Sie Ihre bevorzugte Sprache fest

<!-- <img src={require("./img/settings/settings-general.png").default} alt="settings-general" width="400"/>-->
<img src={require("./img/settings/settings-general.png").default} alt="settings-general" width="400"/>

### Erweiterte Einstellungen

Expand All @@ -31,24 +33,26 @@ Sie können die Einstellungen des OpenCloud Desktop mit den folgenden Schritten
- Bearbeiten Sie die Liste der ignorierten Dateien
- Aktivieren Sie eine Debug-Protokolldatei für die Fehlersuche

<!-- <img src={require("./img/settings/settings-advanced.png").default} alt="settings advanced" width="400"/>-->
<img src={require("./img/settings/settings-advanced.png").default} alt="settings advanced" width="400"/>

### Netzwerkeinstellungen

- Wählen Sie aus, wie der Client mit Proxy-Einstellungen umgehen soll:
- **Kein Proxy**
- **Systemproxy verwenden** (Standard)
- **Manuelles Eingeben eines Proxys**
- Kein Proxy
- Systemproxy verwenden (Standard)
- Manuelles Eingeben eines Proxys

<!-- <img src={require("./img/settings/settings-network.png").default} alt="settings network" width="400"/>-->
<img src={require("./img/settings/settings-network.png").default} alt="settings network" width="400"/>

### Download- und Upload-Bandbreite

- Legen Sie Bandbreitenlimits fest:
- **Kein Limit** (Standard)
- **Automatische Anpassung des Limits**
- **Ein bestimmtes Limit manuell einstellen**
- Kein Limit (Standard)
- Automatische Anpassung des Limits
- Ein bestimmtes Limit manuell einstellen

<!-- <img src={require("./img/settings/settings-bandwidth.png").default} alt="settings bandwith" width="400"/>-->
<img src={require("./img/settings/settings-bandwidth.png").default} alt="settings bandwith" width="400"/>

Indem Sie diese Einstellungen anpassen, können Sie OpenCloud Desktop nach Ihren Bedürfnissen optimieren!
:::note
Indem Sie diese Einstellungen anpassen, können Sie OpenCloud Desktop nach Ihren Bedürfnissen optimieren!
:::
Loading