-
-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Map your Nextcloud to a real Windows drive letter and keep it healthy. NcDavTray is a small tray application written in Windows PowerShell 5.1 + WinForms, with a little embedded C# for the shell notifications. It needs no administrator rights for its normal work, no runtime, and nothing installed system-wide.
Tip
TL;DR — Download the release ZIP, run Installer.cmd, pick Installed or Portable. Add a mount from the tray: either a Nextcloud account — enter the server and let the browser fetch the app password — or a public share link. NcDavTray maps it to a drive letter, gives it an Explorer label and icon, and remounts it whenever the server comes back. Several mounts run side by side — see Server identities for the one Windows limit that matters.
Installing it — Installation covers both modes, the requirements, and how updates and uninstall work.
Setting it up — Mounts is the central page: what a mount is, the two kinds, drive letters, labels, subfolders, and how to enable or disable one without deleting it. Accounts and app passwords covers the account side of it — the browser login, what it is good for, and why the passwords it makes have to be looked after. Share links goes into public links specifically.
Understanding what you see — The tray explains the manager icon, the per-mount icons, what their shapes and colours mean, and every menu entry.
Windows keeps one login per server identity, and NcDavTray can present at most two identities per host. That is a Windows limit, not an application one, and it is the single most common surprise when setting up more than two logins against the same Nextcloud. What counts is the login, not the mount: share links without a password all sign in the same way and share one place between them.
Important
If you plan more than two logins on the same server, read Server identities before you configure them. It explains what Windows counts, why error 1219 appears, and which combinations work.
| Page | What it answers |
|---|---|
| Troubleshooting | What the error numbers mean, what is not an error at all, and how to collect a report |
| File locking | Where the lock comes from, why a sync folder does not produce one, and what files_lock adds |
| WebClient service | The Windows WebDAV redirector: limits, timeouts, and the tuning tab |
| WebDAV cache | What the redirector caches, how to watch it and how to clear it |
| Updates | The update check, what it does and does not do, and how to update by hand |
| Security and privacy | Where the password lives in each mode, and every host the app talks to |
| Languages | Live language switching and how to add a language pack |
| Build from source | The module tree, make.cmd, and how a release is assembled |
| Glossary | Every term this wiki uses, from WebDAV and DPAPI to STA mode, in one sentence each |
Version 2 changed the configuration model: a single account became a list of mounts. Your existing setup is migrated on first start, and nothing is lost.
- Differences between 1 and 2 — what changed, what it means for you, and what to do if you want to go back
- NcDavTray 1.x — the documentation of the 1.x line, kept as it was
Something broken, something unclear, or an idea? Troubleshooting covers the error numbers and the states that only look like errors. If that does not settle it, open an issue with the output of the diagnostics script — the answer will come much faster.
© 2025 - 2026 [ernolf] Raphael Gradenwitz · GPL-3.0-or-later · Report an issue
Getting started
Using it
When something is wrong
Windows internals
Keeping it current
Development
Reference
NcDavTray 1.x