Skip to content

Commit 97cee5e

Browse files
committed
Add desktop troubleshooting page and iOS WebDAV cloud management section
1 parent 2d318b7 commit 97cee5e

File tree

2 files changed

+56
-0
lines changed

2 files changed

+56
-0
lines changed

docs/desktop/troubleshooting.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
id: troubleshooting
3+
title: Troubleshooting
4+
sidebar_position: 14
5+
---
6+
7+
# Troubleshooting
8+
9+
This page contains solutions for common issues you might encounter when using Cryptomator on desktop platforms.
10+
11+
## Log File Locations {#log-file-locations}
12+
13+
Cryptomator creates log files to help with troubleshooting when issues occur. The default locations for these log files vary by operating system:
14+
15+
| Operating System | Default Log File Location |
16+
| :--------------- | :------------------------------------------- |
17+
| Windows | `%appdata%\Cryptomator\cryptomator.log` |
18+
| macOS | `~/Library/Logs/Cryptomator/cryptomator.log` |
19+
| Linux | `~/.Cryptomator/cryptomator.log` |
20+
21+
You can change the log file directory by setting the `cryptomator.logDir` property in the [advanced configuration](advanced-settings.md). This allows you to store log files in a custom location if needed.
22+
23+
## Debug Mode {#debug-mode}
24+
25+
Debug mode enables additional diagnostic logging to help troubleshoot issues with Cryptomator. When debug mode is active, the application records more detailed information about its operations in the log files.
26+
27+
:::warning Privacy Consideration
28+
With debug mode enabled, the paths of all files you encrypt are stored in the log file. This creates a record of your file and folder names, which may compromise privacy. Only enable debug mode when actively troubleshooting an issue, and remember to disable it afterward.
29+
:::
30+
31+
To enable debug mode:
32+
33+
1. Open Cryptomator and navigate to the settings
34+
2. Look for the `Enable debug logging` checkbox and enable it
35+
36+
The additional debug information will now be written to your log files. Once you have reproduced the issue you're investigating, disable debug mode by unchecking the option to return to normal logging levels.
37+
38+
## Known Issues {#known-issues}
39+
40+
For a list of known issues, please refer to the [Cryptomator Community](https://community.cryptomator.org/c/help/known-issues/16) or [GitHub Issues page](https://github.com/cryptomator/cryptomator/issues).

docs/ios/cloud-management.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,22 @@ sidebar_position: 2
66

77
# Cloud Management
88

9+
## WebDAV {#webdav}
10+
11+
Please see [Cloud Services With WebDAV Support](/docs/misc/supported-cloud-services.md#cloud-services-with-webdav-support) for a non-exhaustive list of Cloud Services and information about accessing them with WebDAV.
12+
13+
:::note
14+
While creating the WebDAV connection, please make sure to add the root of the accessible storage and don't navigate directly into the vault.
15+
:::
16+
17+
If you encounter the `Request method not supported by the target resource.` error, it means that the WebDAV URL entered is invalid or the server doesn't support WebDAV properly.
18+
19+
To resolve this:
20+
1. Verify you're using the correct WebDAV URL for your cloud service
21+
2. Check the [list of supported cloud services](/docs/misc/supported-cloud-services.md#cloud-services-with-webdav-support) for the correct WebDAV URLs
22+
3. Ensure your cloud provider has WebDAV enabled (some require enabling it in account settings)
23+
4. If using 2FA, you might need to generate an app-specific password for WebDAV access
24+
925
## Other File Provider {#other-file-provider}
1026

1127
This option allows you to add a vault from any supported [file provider](https://developer.apple.com/documentation/fileprovider/). Default implementations by Apple are iCloud Drive and On My iPhone/iPad. Inside the Files app, you can also add custom connections to SMB-compatible servers.

0 commit comments

Comments
 (0)