owntone-server/docs/advanced/remote-access.md
Hugh Cole-Baker 34eedf4d1b
Update dns-sd arguments for modern Apple Music app
Just having the "ffid=..." argument doesn't seem to be enough to make the owntone library appear in recent versions of Apple's Music.app; I copied the extra arguments from a real instance of Music.app and with them, the owntone library is usable in Music.app like it used to work in iTunes.
2025-07-13 10:31:13 +01:00

29 lines
1.2 KiB
Markdown

# Remote Access
It is possible to access a shared library over the internet from a DAAP client
like iTunes. You must have remote access to the host machine.
First log in to the host and forward port 3689 to your local machine. You now
need to broadcast the DAAP service to iTunes on your local machine. On macOS the
command is:
```shell
dns-sd -P iTunesServer _daap._tcp local 3689 localhost.local 127.0.0.1 "txtvers=1" "ffid=12345678" "Database ID=0123456789abcdef" "Machine ID=0123456789abcdef" "Machine Name=owntone" "mtd-version=28.10" "iTSh Version=131073" "Version=196610"
```
The `ffid` key is required but its value does not matter.
Your library will now appear as 'iTunesServer' in iTunes.
You can also access your library remotely using something like Zerotier. See [this
guide](https://github.com/owntone/owntone-server/wiki/Accessing-Owntone-remotely-through-iTunes-Music-with-Zerotier)
for details.
## Accessing from Internet for authenticated users
If you intend to access OwnTone directly from Internet, it is recommended to
protect it against unauthenticated users.
[This guide](https://blog.cyril.by/en/software/example-sso-with-authelia-and-owntone)
has a detailed setup tutorial to achieve this securely.