diff --git a/docs/user/admin/settings.md b/docs/user/admin/settings.md index 1670e3e5..1bd22f22 100644 --- a/docs/user/admin/settings.md +++ b/docs/user/admin/settings.md @@ -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: + Admin settings ## 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. Admin general ## 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) Admin users ## 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. Admin groups ## 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 Admin spaces +:::note These admin settings allow you to comprehensively manage and customise your OpenCloud environment! +::: diff --git a/docs/user/admin/web-dav.md b/docs/user/admin/web-dav.md index 91cc8b36..af297452 100644 --- a/docs/user/admin/web-dav.md +++ b/docs/user/admin/web-dav.md @@ -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" -Enable WebDAV info + Enable WebDAV info -### 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/` WebDAV URL -### 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//` -> ✅ 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 -::: + :::