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
33 changes: 18 additions & 15 deletions docs/user/admin/settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,38 +9,41 @@ draft: false
# 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

- **Overview of edition and version**:
You can view information about the **Edition** and **Version** of your OpenCloud.
- Overview of edition and version:
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

- **Overview of users**:
Here you have an overview of all **users** of your OpenCloud.
- **Manage users**:
- Overview of users:
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)
<img src={require("./img/settings/admin_users.png").default} alt="Admin users" width="1920"/>

## Groups

- **Overview of the groups**:
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.
- **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.
- Overview of the groups:
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.
- 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.
<img src={require("./img/settings/admin_groups.png").default} alt="Admin groups" width="1920"/>

## Spaces

- **Overview of the Spaces**:
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**
- Overview of the Spaces:
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
<img src={require("./img/settings/admin_spaces.png").default} alt="Admin spaces" width="1920"/>

:::note
These admin settings allow you to comprehensively manage and customise your OpenCloud environment!
:::
68 changes: 37 additions & 31 deletions docs/user/admin/web-dav.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,85 +2,91 @@
sidebar_position: 3
id: web-dav
title: WebDAV
description: Connect to a Space via WebDAV
draft: false
---

# 🌐 Connect to a Space via WebDAV
# Connect to a Space via 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
## Prerequisites

- A valid **OpenCloud account** with WebDAV information enabled in the preferences
- Access to a **Space** in OpenCloud
- A **WebDAV client** (e.g. built-in OS support or [Mountain Duck](https://mountainduck.io/))
- (Optional but recommended) An **App Token**
- A valid OpenCloud account with WebDAV information enabled in the preferences
- Access to a Space in OpenCloud
- A WebDAV client (e.g. built-in OS support or [Mountain Duck](https://mountainduck.io/))
- (Optional but recommended) An App Token
→ [How to create an App Token](./app-tokens.md)

## 🔧 Step-by-Step Guide
## Step-by-Step Guide

### 1. Enable WebDAV Info in the UI
### Enable WebDAV Info in the UI

To display WebDAV information for your Spaces:

1. Go to **Account Settings**
2. Enable **"Show WebDAV info in details view"**
- Go to Account Settings
- 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)
### Create an App Token (if required)

Some WebDAV clients (especially non-OIDC compatible ones like Mountain Duck) require an App Token for authentication.

> 🔐 We recommend using an App Token instead of your password for better security.
:::note
We recommend using an App Token instead of your password for better security.
:::

- Go to **Settings > App Tokens**
- Click **"+ New"**, give it a name, and set an expiration date
- **Copy the token immediately** – it will only be shown once
- Go to Settings > App Tokens
- Click "+ New", give it a name, and set an expiration date
- Copy the token immediately – it will only be shown once
→ [See App Token Guide](./app-tokens.md)

### 3. Get the WebDAV URL
### Get the WebDAV URL

Open the **info panel** of your Space in the OpenCloud Web Interface.
Open the info panel of your Space in the OpenCloud Web Interface.

You’ll see a section labeled **WebDAV** — copy the full WebDAV URL. It looks like:
You’ll see a section labeled WebDAV — copy the full WebDAV URL. It looks like:

`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"/>

### 4. Connect via WebDAV
### Connect via WebDAV

Now connect your device using the WebDAV URL:

- **Username**: your OpenCloud username
- **Password**: your **App Token** (or password, if allowed)
- Username: your OpenCloud username
- Password: your App Token (or password, if allowed)

You can use various clients depending on your operating system:

## 🪟 Windows
## Windows

- Open **File Explorer** → Click on **“This PC”** → Choose **“Map network drive”**
- 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…”**
- 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
- 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.
:::note
Once connected, your Space will behave like a normal folder.
:::

:::note

- If your WebDAV client supports **OIDC**, you may not need an App Token
- 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

:::
:::