
Lunarr is a self-hosted media streaming server and Plex alternative that lets you organize, scan, and stream your movie and TV show libraries from local disks, SFTP, or WebDAV. It automatically matches files with TMDb metadata, supports direct play and on-the-fly HLS transcoding with FFmpeg (including hardware acceleration), sidecar subtitles, Chromecast, and AirPlay. Built for headless servers, it offers personalized recommendations, continue watching, a modern web UI, and full API support. In this step by step guide I will show you how to install LunarrĀ on your Asustor NAS using Docker & Dockhand.
This guide works perfectly with the latest Lunarr v0.7.0 release.
STEP 1
Please Support My work by Making a Donation.
STEP 2
InstallĀ Dockhand using my step by step guide. If you already have Dockhand installed on your Asustor NAS, skip this STEP. ā ļøAttention: Make sure you have installed the latest Dockhand version.
STEP 3
Go toĀ File ExplorerĀ and open the Docker folder. Inside the Docker folder, create one new folder and name it lunarr. Follow the instructions in the image below.
Note: Be careful to enter only lowercase, not uppercase letters.

STEP 4
Now create two new folders inside the lunarr folder that you have previously created at STEP 3Ā and name them config and media. Follow the instructions in the image below.
Note: Be careful to enter only lowercase, not uppercase letters.

STEP 5
Open your browser and type in http://asustor-ip-address:3866 to connect to your Dockhand container. On the left sidebar, click Stacks then + Create. Follow the instructions in the image below.

STEP 6
In the Stack name field, type in lunarr. ā ļøWarning: Type in the name in lowercase letters. The installation process can take up to a few seconds/minutes. It will depend on your Internet speed connection. Follow the instructions in the image below.
services:
lunarr:
image: sayem314/lunarr:latest
container_name: Lunarr
healthcheck:
test: timeout 10s bash -c ':> /dev/tcp/127.0.0.1/3000' || exit 1
interval: 10s
timeout: 5s
retries: 3
start_period: 90s
user: 0:0
security_opt:
- no-new-privileges:true
volumes:
- /volume1/Docker/lunarr/config:/data:rw
- /volume1/Docker/lunarr/media:/media:ro
ports:
- 3499:3000
environment:
AUTH_SECRET: fjvudiPQtKiThYDYQhVIgddaejaFRZkq
ORIGIN: http://192.168.1.84:3499 #or DDNS with https:// at the beginning
restart: on-failure:5
Note: Before you paste the code above in the Stack editor area below, change the volume path for your media files with your own volume path without changing this line :/media:ro
Note: Before you paste the code above in the Stack editor area below, change the value for AUTH_SECRET. (Generate your own Random 32 length AUTH_SECRET.)
Note: Before you paste the code above in the Stack editor area below, change the value for ORIGIN. Type in your own local NAS IP followed by :3499 with http:// at the beginning.

STEP 7
If everything goes right, you will see the following message at the bottom right of your screen: āCreated stack “lunarr”ā.

STEP 8
On the left sidebar, click Containers. Identify your LunarrĀ container then click on ports 3499:8000. Follow the instructions in the image below.

STEP 9
š¢Please Support My work by Making a Donation. Almost 99,9% of the people that install something using my guidesĀ forget to support my work, or justĀ ignoreĀ STEP 1. Iāve been very honest about this aspect of my work since the beginning: I donāt run any ADS, I donāt require subscriptions, paid or otherwise, I donāt collect IPs, emails, and I donāt have any referral links from Amazon or other merchants. I also donāt have any POP-UPs or COOKIES. I have repeatedly been told over the years how much I have contributed to the community. Itās something I love doing and have been honest about my passion since the beginning. But I also Need The Community to Support me Back to be able to continue doing this work.
STEP 10
The installation process can take up to a few seconds/minutes. It will depend on your Internet speed connection. Now open your browser andĀ type in http://asustor-ip-address:3499 Create your administrator user. Click Create admin. Follow the instructions in the image below.

STEP 11
Click the Libraries tab. Give a name to the library. In the Folder path area, type in /media
Click Add library. Follow the instructions in the image below.

STEP 12
Click Scan and wait until your full library is scanned. This can take some time depending on how large your movie library is.

Enjoy Lunarr on You Asustor NAS!
This post was updated on Thursday / July 16th, 2026 at 11:47 PM