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: 0 additions & 2 deletions docs/admin/resources/common-issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,6 @@ id: common-issues
title: Common Issues & Help
---

---

### Check whether the containers are running

```bash
Expand Down
50 changes: 24 additions & 26 deletions docs/user/admin/app-tokens.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,54 +2,52 @@
sidebar_position: 2
id: app-tokens
title: App Tokens
description: App Tokens in OpenCLoud
draft: false
---

## 🔑 App Tokens
# App Tokens

App Tokens allow you to connect external apps and services (such as WebDAV clients) securely without using your main password.

---

### ✅ How to Create an App Token

1. Go to the **App Tokens** section in your OpenCloud account settings.
2. Click on **“+ New”** to create a new token.
3. Enter a **name** for the token (e.g., "WebDAV Client").
4. Select an **expiration date** for added security.
5. Click **Create**.

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

---
- Go to the App Tokens section in your OpenCloud account settings.
- Click on “+ New” to create a new token.
- Enter a name for the token (e.g., "WebDAV Client").
- Select an expiration date for added security.
- Click Create.

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

- Once the token is created, it will be shown **only once**.
- **Copy it immediately** and store it in a secure place.
## Copy the App Token

<img src={require("./img/app-tokens/copy-token.png").default} alt="Copy Token" width="400"/>
- Once the token is created, it will be shown only once.
- Copy it immediately and store it in a secure place.

> ⚠️ If you lose the token, you’ll need to delete it and create a new one.
<img src={require("./img/app-tokens/copy-token.png").default} alt="Copy Token" width="400"/>

---
:::note
If you lose the token, you’ll need to delete it and create a new one.
:::

### 🔧 Use the Token
## Use the App Token

You can now use the token in place of your password when connecting:

- WebDAV
- External apps
- Third-party services

---

### 🗑️ Delete a Token
## Delete the App Token

If a token is no longer needed:

1. Go back to the **App Tokens** section.
2. Click the **trash icon** next to the token to remove it.
- Go back to the App Tokens section.
- Click the trash icon next to the token to remove it.

This ensures unused tokens cannot be misused.

> ✅ Use App Tokens for better security and control when connecting external services.
:::note
Use App Tokens for better security and control when connecting external services.
:::
40 changes: 16 additions & 24 deletions docs/user/admin/settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,53 +2,45 @@
sidebar_position: 1
id: settings
title: Settings
description: Settings
draft: false
---

## Admin area overview
# Admin area overview

In the admin area of OpenCloud you have extensive administration options for your organisation. Here are the most important areas:
<img src={require("./img/settings/admin_settings.png").default} alt="Admin settings" width="400"/>

---

### General
## General

- **Overview of edition and version**:
You can view information about the **Edition** and **Version** of your OpenCloud.
You can view information about the **Edition** and **Version** of your OpenCloud.
<img src={require("./img/settings/admin_general.png").default} alt="Admin general" width="1920"/>

---

### Users
## Users

- **Overview of users**:
Here you have an overview of all **users** of your OpenCloud.
Here you have an overview of all **users** of your OpenCloud.
- **Manage users**:
Depending on your user management settings, you can: - Create or delete users - Edit users (e.g. change rights or settings) - Change quota (storage space) of users - Add or remove users in groups - Allow or prohibit logins (for individual users)
Depending on your user management settings, you can: - Create or delete users - Edit users (e.g. change rights or settings) - Change quota (storage space) of users - Add or remove users in groups - Allow or prohibit logins (for individual users)
<img src={require("./img/settings/admin_users.png").default} alt="Admin users" width="1920"/>

---

### Groups
## Groups

- **Overview of the groups**:
Here you can view the existing **groups** of your OpenCloud.
Here you can view the existing **groups** of your OpenCloud.
- **Manage groups**:
You can **create, edit or delete** local groups and add or remove members.
You can **create, edit or delete** local groups and add or remove members.
- **Imported groups**:
External groups that have been imported via an external user management system can **not be edited** here. These groups are labeled with a **lock symbol** to indicate that they are locked.
External groups that have been imported via an external user management system can **not be edited** here. These groups are labeled with a **lock symbol** to indicate that they are locked.
<img src={require("./img/settings/admin_groups.png").default} alt="Admin groups" width="1920"/>

---

### Spaces
## Spaces

- **Overview of the Spaces**:
Here you can see all existing **Spaces** in your OpenCloud.
Here you can see all existing **Spaces** in your OpenCloud.
- **Space management**:
As an administrator, you have full rights to: - **Edit** - **Deactivate or activate** - **Delete**
As an administrator, you have full rights to: - **Edit** - **Deactivate or activate** - **Delete**
<img src={require("./img/settings/admin_spaces.png").default} alt="Admin spaces" width="1920"/>

---

**These admin settings allow you to comprehensively manage and customise your OpenCloud environment!**
These admin settings allow you to comprehensively manage and customise your OpenCloud environment!
24 changes: 8 additions & 16 deletions docs/user/admin/web-dav.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,6 @@ title: WebDAV

With WebDAV, you can connect OpenCloud Spaces as network drives on your device and manage your files directly from your file manager — without using the browser.

---

## 🛠️ Prerequisites

- A valid **OpenCloud account** with WebDAV information enabled in the preferences
Expand All @@ -18,8 +16,6 @@ With WebDAV, you can connect OpenCloud Spaces as network drives on your device a
- (Optional but recommended) An **App Token**
→ [How to create an App Token](./app-tokens.md)

---

## 🔧 Step-by-Step Guide

### 1. Enable WebDAV Info in the UI
Expand All @@ -29,7 +25,7 @@ To display WebDAV information for your Spaces:
1. Go to **Account Settings**
2. Enable **"Show WebDAV info in details view"**

## <img src={require("./img/webdav/preferences.png").default} alt="enable webdav info" width="1920"/>
<img src={require("./img/webdav/preferences.png").default} alt="Enable WebDAV info" width="1920"/>

### 2. Create an App Token (if required)

Expand All @@ -42,8 +38,6 @@ Some WebDAV clients (especially non-OIDC compatible ones like Mountain Duck) req
- **Copy the token immediately** – it will only be shown once
→ [See App Token Guide](./app-tokens.md)

---

### 3. Get the WebDAV URL

Open the **info panel** of your Space in the OpenCloud Web Interface.
Expand All @@ -52,9 +46,7 @@ You’ll see a section labeled **WebDAV** — copy the full WebDAV URL. It looks

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

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

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

### 4. Connect via WebDAV

Expand All @@ -65,30 +57,30 @@ Now connect your device using the WebDAV URL:

You can use various clients depending on your operating system:

#### 🪟 Windows
## 🪟 Windows

- Open **File Explorer** → Click on **“This PC”** → Choose **“Map network drive”**
- Enter the WebDAV URL
- Authenticate with username and App Token

#### 🍎 macOS
## 🍎 macOS

- In **Finder**, choose **“Go” > “Connect to Server…”**
- Enter the WebDAV URL
- Login with your credentials or App Token

#### 🐧 Linux
## 🐧 Linux

- Use your file manager’s **“Connect to Server”** option
- Format the URL as:
`davs://cloud.example.com/remote.php/dav/spaces/<SPACE-ID>/`

> ✅ Once connected, your Space will behave like a normal folder.

---

## 📌 Notes
:::note

- If your WebDAV client supports **OIDC**, you may not need an App Token
- Always use `https://` to ensure secure access
- App Tokens can be revoked anytime via your account settings

:::
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,14 @@
sidebar_position: 1
id: create-rename-move
title: Create - Rename - Move (Android)
description: Create - Rename - Move
draft: true
---

# 📁 Create, Rename, and Move Files and Folders

The OpenCloud Android App makes it easy to manage your content. You can create new folders and files, rename items, and move them to different locations — all directly from your Android phone or tablet.

---

## ➕ Creating Files and Folders

1. Tap the **“+”** button in the bottom right corner.
Expand Down Expand Up @@ -42,8 +41,6 @@ The document will open in a built-in browser window using **Collabora** for edit
<!-- <img src={require("../img/files-and-folders/create-rename-move-android/open-collabora.png").default} alt="Open Collabora" height="400"/>
<img src={require("../img/files-and-folders/create-rename-move-android/edit-collabora.png").default} alt="Edit Collabora" height="400"/> -->

---

## ✏️ Rename Files or Folders

To rename a file or folder in the OpenCloud Android App:
Expand All @@ -67,8 +64,6 @@ To rename a file or folder in the OpenCloud Android App:

✅ The new name will be saved immediately.

---

## 📁 Move Files or Folders

To move a file or folder in the OpenCloud Android App:
Expand All @@ -88,5 +83,3 @@ To move a file or folder in the OpenCloud Android App:
<img src={require("../img/files-and-folders/create-rename-move-android/file-moved.png").default} alt="File is moved" height="400"/> -->

✅ The file or folder will now appear in the new location.

---
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,14 @@
sidebar_position: 2
id: upload-make-available-offline
title: Upload - Make available offline
description: Upload files in Android
draft: true
---

# 📤 Upload Files & Make Them Available Offline (Android)
# 📤 Upload Files in Android

With the OpenCloud Android App, you can easily upload files and make them available for offline use.

---

## 🔼 Upload Files

### 1. Open the Desired Folder
Expand All @@ -34,8 +33,6 @@ From the menu, you can choose:

Choose the file or media you want to upload. The upload will begin automatically.

---

## 📥 Make Files Available Offline

You can make files available offline so you can access them even without an internet connection.
Expand All @@ -54,15 +51,11 @@ The file will be downloaded and saved locally on your device.

<!-- <img src={require("../img/files-and-folders/upload-make-available-offline-android/marked-offline.png").default} alt="Marked offline" height="400"/> -->

---

## 🔄 Remove Offline Availability

To free up space:

- Tap the **three dots (⋮)** on an offline file
- Select **“Unset as available offline”**

---

These features help you stay productive — even when you’re offline!
30 changes: 22 additions & 8 deletions docs/user/android-app/general/installation.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,37 @@
---
sidebar_position: 1
id: installation
title: Install the Android App
title: Install OpenCloud Android app
description: Install OpenCloud Android app
draft: true
---

# 📱 Installing the Android App
# Install OpenCloud Android app

1. Open the **Play Store** on your Android Smartphone or Tablet.
A short Tutorial how to install the OpenCloud Android App.

## Play Store

Open the **Play Store** on your Android Smartphone or Tablet.

## OpenCloud

Search for **"OpenCloud"** or click the following link to go directly to the app:

2. Search for **"OpenCloud"** or click the following link to go directly to the app:
<!-- [OpenCloud on the Play Store](https://) -->

<!-- <img src={require(".././img/installation/android-installation.jpg").default} alt="Android Installation" height="400"/> -->

3. Tap **"Get"** to install the app.
## Install

Tap **"Get"** to install the app.

## App Icon

After installation, you will find the OpenCloud app on your home screen.

4. After installation, you will find the OpenCloud app on your home screen.
<!-- <img src={require(".././img/installation/icon-on-screen.png").default} alt="Icon" height="400"/> -->

<!-- <img src={require(".././img/installation/icon-on-screen.png").default} alt="icon" height="400"/> -->
## Set it up

5. Open the app and follow the on-screen instructions to set it up.
Open the app and follow the on-screen instructions to set it up.
Loading