Mapping it as a drive (WebDAV)

Open your ThirtyFile spaces in Windows File Explorer, macOS Finder, a WebDAV-compatible mobile app or rclone, as if they were a drive on your computer.

The address and signing in

ThirtyFile speaks WebDAV at /dav/ on its own address, for example:

https://files.example.com/dav/

Sign in with your username and an app password, never your own password. Create one for each computer or phone under App passwords in the account menu:

• Choose Read and change files to work with your files. A read-only app password can open and download files but can't save, create, rename, move or delete anything.
• Accounts that sign in with single sign-on use an app password here too.
• Two-factor sign-in doesn't ask for a code here. Wrong app passwords count towards the usual limit: after 30 from one address, that address has to wait 15 minutes.

What you see

The top folder holds one folder per space you can use:

• My files, your personal space, if you have one.
• The company space (All files, unless your administrator renamed it) and your team spaces, by their names. If two have the same name, the later one gets a number, such as Projects (2).
• Shared with me: folders and files other people shared with you from spaces you aren't a member of.

These are the same paths the address bar shows in the browser, where you can also type or paste them (see Paths).

Everything works as it does in the browser: what you may change depends on your permissions, read-only spaces can't be changed, the space's storage limit and the upload size limit apply, and every change shows in the activity log. Deleting a file or folder moves it to the trash, where you can restore it in the browser.

Windows

Windows' built-in client needs the WebClient service. Microsoft has deprecated that service and it is not started by default; availability depends on your Windows installation and administrator's policy. If drive mapping is unavailable, use a dedicated WebDAV client or rclone. See Microsoft's WebClient notice.

1. In File Explorer, right-click This PC and choose Map network drive (on Windows 11, it's under … (See more) in the toolbar).
2. Pick a drive letter and enter the address in Folder: https://files.example.com/dav/
3. Tick Connect using different credentials, choose Finish, and enter your username and the app password. Tick Remember my credentials to connect again after a restart.

macOS

1. In Finder, choose Go › Connect to Server (⌘ K).
2. Enter https://files.example.com/dav/ and choose Connect.
3. Choose Registered User and enter your username and the app password. Tick Remember this password in my keychain if you like.

The spaces appear as a drive in the Finder sidebar under Locations. Finder saves hidden files starting with ._ next to files with extra information; they appear in the browser too, and can be deleted.

iPhone, iPad and Android

• iPhone and iPad: use an app that explicitly supports WebDAV over HTTPS. Add the address, your username and an app password there. If that app offers a Files provider, enable it in the Files app to browse the connection there. Files' built-in Connect to Server is for SMB servers; it does not connect directly to ThirtyFile's /dav/ endpoint. Apple's Files feature notes describe its SMB support.
• Android: use a file manager or client that explicitly supports WebDAV over HTTPS, and add the address, your username and an app password. Support for SMB, FTP or SFTP alone does not make an app a WebDAV client.

rclone

rclone copies and syncs files with ThirtyFile from the command line, for example for backups. Use its interactive configuration so your app password is not written into shell history:

rclone config

Make a new remote named thirtyfile, choose webdav, set the URL to https://files.example.com/dav/, choose other as the vendor, and enter your ThirtyFile username and app password when prompted. Leave a bearer token empty when using this username/password setup. rclone obscures the saved password, which is reversible: protect its configuration file as a credential.

Then use it like any other rclone remote:

rclone ls "thirtyfile:My files"
rclone copy ~/Pictures "thirtyfile:My files/Pictures" --progress
rclone mount thirtyfile: ~/ThirtyFile --vfs-cache-mode writes

A read-only app password is enough for rclone copy from ThirtyFile, for example to back your files up to another place.

If connecting or saving fails

• 401 or repeated password prompts: use a username and an app password, not your browser password, email address or a two-factor code. Check that the app password has not expired or been revoked and that the account is enabled. After too many failed attempts, wait 15 minutes before trying again.
• You can read but cannot save: check the app password's write scope, your permission in the space, the storage limit and whether the location is read-only or offline.
• 404, a login web page or an unexpected redirect: use the complete /dav/ address and configure the reverse proxy to forward WebDAV methods and the Authorization header. An HTML sign-in page is not a WebDAV response.
• Certificate or large-file errors: use HTTPS with a trusted certificate. Check both the client's transfer limit and the proxy's request size and timeouts. The browser uploader sends chunks; WebDAV sends a whole file in one request.

Good to know

• Each file is sent in one piece. When ThirtyFile is behind a reverse proxy, the proxy must let large requests through: see Putting it on the internet.
• Names follow the same rules as in the browser: characters Windows doesn't allow in names (\ / : * ? " < > |) are refused.
• Office and other programs lock files while they are open. ThirtyFile answers these locks so that saving works, but doesn't enforce them: when two people save the same file at the same time, the last one wins. Use the browser's online editor for working on a file together.
• Folders on the server (folder spaces) work too: changes are made in the folder itself, and files added on the server show up when the folder is opened.
• Moving or copying a large folder to or from a folder on the server copies its files. ThirtyFile answers when that is done; when it takes more than a minute, it answers that the change was accepted and finishes it in the background, even if the program gives up waiting or loses its connection. Look again a little later to see the result.
• Moving an item that was shared with you to one of your own spaces isn't allowed, as in the browser; copy it instead.
• Each folder is listed one level at a time; a client that asks for a whole tree at once is told to ask folder by folder, which all common clients do.