Skip to content
OVO

Cloud & Offline

WebDAV Music Player for iPhone: Setup and Offline Sync

A practical guide to secure WebDAV setup on iPhone, the difference between streaming and syncing, offline verification, and the errors that stop a music library from updating.

By OVO Editorial Team · · 12 min read

An iPhone showing OVO's WebDAV synced-folder setup beside a locally available music library.

An iPhone showing OVO's WebDAV synced-folder setup beside a locally available music library.

A WebDAV music player for iPhone connects to a folder on a compatible server, discovers the audio files inside it, and then either streams, caches, or downloads those files—the exact behavior depends on the player. OVO uses a synced-folder model: you connect an HTTPS WebDAV folder, tap Update, and OVO brings supported songs into managed storage on the iPhone so they can play without the server later.

That distinction matters. A remote folder appearing in an app does not prove its songs are available offline. If you want music for a flight, subway, or unreliable network, finish the download or sync first and test the library in Airplane Mode.

What WebDAV is—and what it does not guarantee

WebDAV is a set of extensions to HTTP for working with remote resources and collections. In everyday terms, it can let an app list folders, inspect files, download them, and—when permissions allow—manage them on a server.

WebDAV is not a music catalog, a subscription service, or a playback engine. It does not by itself guarantee:

  • gapless playback;
  • a queue, playlists, or library search;
  • artist, album, artwork, or tag organization;
  • support for every audio format;
  • background playback;
  • an offline copy;
  • automatic synchronization.

Those are responsibilities of the iOS music player layered on top of the connection. This is why two apps can accept the same WebDAV URL but behave very differently after they connect.

Remote, streamed, cached, or synced: know the state

“My WebDAV folder is connected” answers only the first question. Before relying on it, identify where the audio bytes actually are.

StateWhere the complete song livesNetwork needed to start playback?Reliable after the app clears temporary data?
Remote listingServer onlyYesNo offline copy exists
On-demand streamServer; small portions may bufferYesNo
Temporary cacheServer plus app-managed temporary dataMaybeNot guaranteed
Synced/downloaded copyServer plus managed storage on iPhoneNo, after completionYes, until you remove it or the app's source rules remove it

OVO's current WebDAV workflow uses the last model. Update scans the linked folder and its subfolders, downloads supported new audio into OVO's managed source storage, and adds it to the library. OVO does not currently present WebDAV as an on-demand streaming source.

If you want the broader decision framework, read Cloud Music Player vs Offline Music Player for iPhone.

What you need before connecting

Collect these details from the server administrator or the storage provider's official documentation:

  1. The exact HTTPS WebDAV endpoint. This may not be the same address as the service's normal web sign-in page. It can also include a required base path.
  2. A username and password with permission to read the music folder. If the service supports a separate app password, using one can make revocation easier.
  3. A valid TLS certificate for the hostname in the URL. An IP address will fail certificate validation when the certificate was issued for a domain name.
  4. A reachable server. A server available only on your home network will not become reachable on cellular merely because the URL was saved on the iPhone.
  5. Enough iPhone storage for the folders you plan to sync. A large lossless library can require far more space than an MP3 or AAC subset.
  6. Audio formats supported by the player. Check OVO's supported audio formats before diagnosing every skipped file as a WebDAV error.

Do not guess an endpoint by repeatedly editing a public URL. Nextcloud, ownCloud, NAS packages, and hosted services can expose different paths and authentication rules. Copy the documented WebDAV address exactly, then select a music folder with the smallest permissions you actually need.

How to add a WebDAV music folder in OVO

WebDAV synced folders are an OVO Pro feature after the onboarding exception. The first-source onboarding path can let you connect content before the normal feature gate is applied; later WebDAV source management follows the current Pro entitlement shown in the app.

To connect a folder:

  1. Open Sources in OVO.
  2. Choose Add Source, then Synced Folder.
  3. Select WebDAV as the provider.
  4. Enter a clear source name, such as “Home NAS Music.” This label is for your OVO library; it does not rename the folder on the server.
  5. Paste the complete Server URL beginning with https://.
  6. Enter the server username and password.
  7. Turn on Update on Wi-Fi only if you do not want a manual Update to download music over cellular.
  8. Add the folder and let the first Update finish.

OVO checks the linked folder recursively, so supported audio inside subfolders can be discovered. During an update, it reports whether it is checking, downloading, syncing, waiting for Wi-Fi, out of storage, unable to reach the source, or only partially successful. A failed file remains eligible for a later retry instead of silently becoming a permanent gap.

You can learn how OVO brings different storage locations together on the Sources page, or see the broader cloud music player for iOS workflow.

How to prove your WebDAV music works offline

Do not use a Wi-Fi icon or a visible album cover as proof. Artwork and metadata can appear before every audio file is local.

Use this test:

  1. In the synced-folder detail screen, wait for Update to report completion. Resolve partial failures first.
  2. Play the beginning of one song from the first album, another from a nested folder, and a third near the end of the selection.
  3. Stop playback and force-quit the app. This reduces the chance that a short buffer masks a missing download.
  4. Turn on Airplane Mode and confirm Wi-Fi is off.
  5. Reopen OVO and play the same songs. Seek into the middle of each track.

If all three tracks start and seek normally, you have much stronger evidence that their complete audio is on the iPhone. If only the song you recently played works, you may be testing a cache rather than a finished sync.

OVO is designed to play its successfully synchronized WebDAV copies locally. The test still matters because an interrupted update, insufficient storage, an unsupported file, or a per-file server error can leave a subset incomplete.

What happens when the server folder changes

Treat the server as the source and OVO's managed copies as the iPhone-side result of the last successful Update.

  • Add a song on the server: tap Update; OVO compares the remote paths and imports supported new files.
  • Remove a song on the server: a later Update detects that the remote path is gone and reconciles the source. A removed local copy can become eligible for download again if it returns to the source.
  • An update partly fails: successful songs remain imported, while failures are reported and can be retried.
  • Change the server password: OVO may ask you to sign in again when the stored credentials no longer work.
  • Restore a backup on another device: WebDAV credentials are not included in OVO backup archives, so expect to reconnect rather than transferring a reusable password inside the archive.

OVO currently preserves a visible, user-initiated Update action. Do not assume that changing a file on the server will immediately push it to the iPhone in the background.

Security: use HTTPS and fix certificate errors

WebDAV can run over HTTP, but credentials must not be exposed over an insecure connection. RFC 4918 specifically warns that HTTP Basic credentials must not be used unless the connection is secure. OVO therefore requires an https:// WebDAV address.

HTTPS is not merely the letters at the start of the URL. The iPhone must also be able to validate that:

  • the certificate was issued by a trusted authority;
  • the hostname you entered matches the certificate;
  • the certificate has not expired;
  • the server supplies the required certificate chain.

If the server's certificate belongs to music.example.com, connecting to https://192.168.1.20/... can fail even when both addresses reach the same NAS. Use the documented hostname and correct certificate configuration. Do not disable certificate verification or publish a private server address to work around the error.

OVO stores the WebDAV password in the iOS Keychain, separately from the synced-folder record. Its portable backups exclude that credential. This creates a little more reconnection work after a restore, but avoids embedding reusable server secrets in a library archive.

WebDAV troubleshooting matrix

Start with the symptom instead of deleting and recreating the entire library.

SymptomLikely class of problemNext check
“Sign In Again,” 401, or 403Wrong/expired credentials or insufficient permissionRe-enter the account or app password; confirm it can read the exact folder
Certificate or secure-connection failureHostname mismatch, expired/self-signed certificate, or incomplete chainUse the hostname on a valid certificate and repair the server's TLS setup
Connects in a browser but OVO rejects the URLNormal website URL is not the WebDAV endpoint, or the server response is not WebDAV-compatibleCopy the provider's documented WebDAV base URL and path
404 or an empty folderWrong base path, encoded folder name, or account rooted elsewhereVerify the endpoint and folder path with the server documentation
“Invalid response” or listing failsRequired WebDAV methods/response format unavailable through the proxy or serverTest the same endpoint with a known compatible client; review proxy and WebDAV method configuration
“Waiting for Wi-Fi”The source is set to update on Wi-Fi onlyJoin Wi-Fi or deliberately turn off that policy before Update
Some songs could not syncPer-file download, format, permission, or connectivity failureCheck the failed files' format and permissions, free space, then run Update again
Insufficient storageThe local copy cannot be completedFree storage or sync a smaller server folder
Previously working server is unavailableNAS asleep, local-only hostname, VPN/remote-access path absent, DNS change, or outageConfirm reachability from the iPhone's current network before changing credentials
Music appears but fails in Airplane ModeUpdate did not complete or only temporary data existsReconnect, finish Update, resolve failures, and repeat the offline verification test

A 401/403 result does not automatically mean the password text is wrong. The account may authenticate but lack access to the chosen collection. Likewise, a successful web login proves that the account exists, not that the pasted URL is a functioning WebDAV endpoint.

When WebDAV is the right source—and when it is not

Choose WebDAV when you control or subscribe to a compatible server, want one server-side folder structure, and are comfortable maintaining an endpoint, credentials, certificate, and network path.

Choose Files/iCloud Drive when your music already appears through an iOS file provider and you prefer selecting the folder through Apple's document interface. Apple documents that supported Files locations can keep selected items downloaded, but provider behavior still varies. OVO can link a Files/iCloud Drive folder as a synced source without requiring a WebDAV URL.

Choose a direct local import when the collection rarely changes and you want the simplest possible offline boundary. Local files are the most predictable choice when no ongoing server relationship is needed. See OVO's local music player guide for that path.

The best option is not the one with the longest feature list. It is the source whose failure modes you are willing to manage. WebDAV gives you control and portability, but it also makes endpoint, certificate, permission, and reachability health your responsibility.

Frequently asked questions

Can a WebDAV music player work offline on iPhone?

Yes, if the player downloads or synchronizes complete audio files before the connection disappears. A remote listing or on-demand stream alone will not work offline. In OVO, finish Update and verify several tracks in Airplane Mode.

Is WebDAV the same as cloud music streaming?

No. WebDAV is a protocol for accessing and managing remote resources over HTTP. A music app may use that access to stream, cache, import, or sync files. OVO's current WebDAV source creates managed local copies through Update.

Which WebDAV URL should I enter?

Use the exact HTTPS WebDAV endpoint supplied by your NAS, hosting provider, Nextcloud/ownCloud administrator, or server documentation. Do not assume the normal browser login address is the endpoint, and do not remove a required base path.

Why does my WebDAV login work on a computer but fail on iPhone?

The iPhone app may be using a different URL, hostname, certificate trust path, authentication method, or folder permission. Compare the full endpoint—not only the username—and confirm the TLS certificate matches the hostname.

Does OVO stream directly from WebDAV?

Not in the current synced-folder workflow. OVO scans the WebDAV folder when you tap Update and imports supported new songs into managed local storage. That design prioritizes predictable offline playback after a successful sync.

Does OVO back up my WebDAV password?

No. OVO keeps the password separately in Keychain and excludes WebDAV credentials from portable backup archives. After restoring on another device, reconnect the source with its current credentials.

Build an offline WebDAV library in OVO

If your music already lives on a compatible server, OVO can turn an HTTPS WebDAV folder into an organized, locally available iPhone library—without pretending that a remote connection is the same as an offline copy.

Download OVO on the App Store and add a WebDAV Synced Folder from Sources. WebDAV synced folders follow OVO's current Pro access rules after the onboarding exception.

Sources

WebDAVcloud music playeroffline musiciPhoneNAS

Keep reading

Local Libraries

How to move a local music library to iPhone

A practical walkthrough for getting an existing folder of audio files onto an iPhone, keeping albums intact and staying offline-ready.

· 7 min read · The OVO Team

Get OVO on the App Store

OVO is an iPhone-first music player that also runs on iPad and Apple Watch. Download it, point it at the music you already own, and start listening.