Raspberry Pi DLNA Server with MiniDLNA (ReadyMedia) – Setup Guide
A DLNA server on the Raspberry Pi lets you stream movies, music and photos to smart TVs, game consoles and other DLNA-capable devices on your home network. In this article I’ll show you how to set up ReadyMedia (formerly MiniDLNA) on Raspberry Pi OS – and introduce you to Jellyfin as a modern alternative.
What is DLNA and ReadyMedia?
DLNA (Digital Living Network Alliance) is a standard that allows devices on a home network to share media content. A DLNA server provides the media; DLNA clients (smart TV, PlayStation, Kodi, VLC) play it back.
ReadyMedia (the project was formerly called MiniDLNA) is a very lightweight DLNA server – ideal for the Raspberry Pi since it uses minimal resources. The package is still called minidlna in the repository.
What do I need?
- Raspberry Pi (any model) with Raspberry Pi OS
- USB hard drive or NAS with your media files – e.g. WD Elements Portable 2TB
- Wired network connection recommended (Wi-Fi works but Ethernet is more stable for video streaming)
Important: USB hard drives without their own power supply need an active USB hub* on Pi 3 and older, as the Pi’s USB port doesn’t supply enough current. On the Pi 4 and Pi 5 with a good power supply (5V/3A or 5V/5A) it usually works directly.
Install and configure ReadyMedia (MiniDLNA)
Installation
Update the system and install MiniDLNA:
sudo apt update && sudo apt upgrade -y
sudo apt install minidlna -y
Configuration
Open the configuration file:
sudo nano /etc/minidlna.conf
The most important settings:
1. Set media path – change the media_dir line to the path of your media:
media_dir=/media/usbdisk/
You can also specify different types (A=Audio, V=Video, P=Photos):
media_dir=A,/media/usbdisk/Music
media_dir=V,/media/usbdisk/Movies
media_dir=P,/media/usbdisk/Photos
2. Set server name (optional, appears on your playback devices):
friendly_name=Raspberry Pi DLNA
3. Enable automatic detection of new files:
inotify=yes
4. Set network interface (remove the hash at the beginning):
network_interface=eth0
Replace eth0 with wlan0 for Wi-Fi. The actual interface name is shown by ip link show.
Save with Ctrl+X, Y, Enter.
Set permissions
MiniDLNA runs under its own user and needs read access to your media directory. Replace pi with your actual username (the one you chose during setup):
sudo chown -R minidlna:minidlna /media/usbdisk/
sudo chmod -R g+rw /media/usbdisk/
sudo usermod -aG minidlna pi
Restart the service
sudo systemctl restart minidlna
sudo systemctl enable minidlna
You don’t need to rebuild the database by hand: if you added or removed a media folder in minidlna.conf, MiniDLNA rebuilds it on its own at startup, and with inotify=yes the service picks up new files while it runs. Skip the often-recommended sudo minidlnad -R – it starts a second MiniDLNA instance as root alongside the service. If the library still shows stale entries or misses files, stop the service, delete the database, and MiniDLNA will rescan everything the next time it starts:
sudo systemctl stop minidlna
sudo rm /var/cache/minidlna/files.db
sudo systemctl start minidlna
Check status
sudo systemctl status minidlna
MiniDLNA’s web interface shows you how many media files have been indexed. Replace raspberrypi with your Pi’s IP address:
http://raspberrypi:8200
Jellyfin – the modern alternative
ReadyMedia is great for simple DLNA streaming, but has limits: no proper web interface, no user accounts, no transcoding. If you want more, take a look at Jellyfin – a free, open-source media server with significantly more features:
- Full web interface and apps for Android, iOS, Kodi, Roku etc.
- Transcoding (converts formats on the fly during streaming)
- Multiple user accounts with permissions
- Automatic metadata, cover art and film descriptions
- Live TV and recording (DVR), using a DVB stick through Tvheadend
Install Jellyfin
curl https://repo.jellyfin.org/install-debuntu.sh | sudo bash
After installation, Jellyfin is accessible on port 8096:
http://raspberrypi:8096
On first launch, a setup wizard guides you through the configuration.
Recommendation: For a pure DLNA server without further requirements, MiniDLNA is perfectly sufficient. If you want a full media library with apps and transcoding, choose Jellyfin.
Comparison: ReadyMedia vs. Jellyfin
| Feature | ReadyMedia (MiniDLNA) | Jellyfin |
|---|---|---|
| Resource usage | Very low (~20 MB RAM) | Medium (~200 MB RAM) |
| Web interface | Status page only | Full-featured |
| DLNA compatible | Yes | Yes |
| Transcoding | No | Yes |
| Metadata / cover art | No | Automatic |
| Mobile apps | No | iOS, Android |
| Setup effort | Low | Medium |
📺 More media center guides for the Raspberry Pi:
- Install Kodi on Raspberry Pi – step-by-step for Raspberry Pi OS (Pi 4 & Pi 5)
- Set up IPTV with Kodi – live TV via FRITZ!Box, waipu.tv and Zattoo
- Raspberry Pi as Smart TV – Netflix, streaming and live TV on your television
- Set up Tvheadend – live TV server with DVB stick for Raspberry Pi
Frequently asked questions about MiniDLNA on Raspberry Pi
MiniDLNA and ReadyMedia are the same project – ReadyMedia is the new official name, MiniDLNA the former name. The Debian/Raspberry Pi OS package is still called minidlna. There are no functional differences: running sudo apt install minidlna installs ReadyMedia.
All DLNA-capable devices on your home network: smart TVs (Samsung, LG, Sony), game consoles (PlayStation 4/5, Xbox), media players (Kodi, VLC, Fire TV) and Android/iOS apps like VLC or BubbleUPnP. The Raspberry Pi must be on the same network as the playback devices.
MiniDLNA is extremely lightweight and only uses around 10–25 MB of RAM during operation. It runs without issues on any Raspberry Pi – even the Pi Zero 2 W with 512 MB RAM. CPU load during streaming is also minimal since MiniDLNA does no transcoding.
Yes. In /etc/minidlna.conf you can add multiple media_dir lines – also with type prefix (A=Audio, V=Video, P=Photo). Example: media_dir=V,/media/usb1/Movies and media_dir=A,/media/usb2/Music. After changes, restart the service with sudo systemctl restart minidlna – MiniDLNA rebuilds the database on its own.
It depends on your use case. MiniDLNA is ideal if you just want to stream files to a smart TV or game console – minimal effort, barely any resources. Jellyfin is worth it if you want a full media library with apps, user accounts, automatic metadata and transcoding. For beginners, MiniDLNA is the recommended starting point.
