Install Vidalune 0.20.6

You need

• A computer or server that is always on (Windows, Linux, a NAS, or macOS with Docker Desktop).
• Docker with Docker Compose v2 — or Debian/Ubuntu or Windows 10/11 (64-bit) for Vidalune without Docker.
• Your movies and series in folders on that machine.

Quick install (Linux)

Run this on your server. It asks where your movies and series are, sets everything up in ~/vidalune (with the graphics of the server, for video conversion) and starts Vidalune:

curl -fsSL https://vidalune.com/get | sh

Install with a compose file

1. Make a folder, for example vidalune, and save this file in it as docker-compose.yml: Download docker-compose.yml

   # Vidalune — https://vidalune.com/install
   # Change the two media folders (left of the ":") to where your movies and series are.
   services:
     vidalune:
       image: vidalune/vidalune:latest
       container_name: vidalune
       restart: unless-stopped
       ports:
         - "3000:3000"
         - "${DIRECT_TLS_PORT:-32400}:${DIRECT_TLS_PORT:-32400}"
       environment:
         TZ: Europe/Amsterdam
         DIRECT_TLS_PORT: ${DIRECT_TLS_PORT:-32400}
         # The user and group that own your media files (see: id your-user)
         PUID: "1000"
         PGID: "1000"
       volumes:
         # Database, artwork, avatars and backups: back this folder up.
         - ./data:/data
         # Your media. Vidalune puts its compatible copies next to a film and deletes only what you
         # approve under Admin > Clean-up. Add :ro to a line to keep that folder read-only.
         - /srv/media/movies:/media/movies
         - /srv/media/tv:/media/tv
   

2. Change the two media folders (left of the ":") to where your movies and series are.
3. Start Vidalune in that folder:

   docker compose up -d

Then open http://<your-server>:3000 and create your administrator account. Metadata, users and libraries are set up there.

Without Docker (Debian/Ubuntu)

A package for Debian 12+ and Ubuntu 22.04+ that installs Vidalune as a service (it starts by itself with the computer). Choose the one for your processor: `uname -m` says x86_64 (amd64: most PCs and servers) or aarch64 (arm64: for example a Raspberry Pi 4/5 with a 64-bit system).

Quickest: run this on the computer. It picks the right package, installs it together with FFmpeg and starts Vidalune:

curl -fsSL https://vidalune.com/get-deb | sudo sh

Or by hand: download the package and install it with apt (apt also installs FFmpeg; with dpkg -i, run sudo apt-get install -f afterwards):

curl -fLo vidalune.deb https://vidalune.com/download/deb/amd64
sudo apt install ./vidalune.deb

arm64: https://vidalune.com/download/deb/arm64

Then open http://<your-server>:3000, create your administrator account and add your movies and series under Admin → Libraries: Browse to the folder and choose it. If Vidalune may not read a folder, it shows the one command that gives it access; run it and add the folder again.

Updates come with the rest of your system: the package adds the Vidalune apt repository, so sudo apt update && sudo apt upgrade updates Vidalune too. Your settings (/etc/vidalune/vidalune.env) and data (/var/lib/vidalune) stay.

Windows

An installer for Windows 10 and 11 (64-bit) with everything Vidalune needs. Vidalune starts when you sign in to Windows and shows an icon next to the clock: right-click it to open Vidalune, restart it or quit it. Quitting the icon also stops the server.

Download for Windows

Then Vidalune opens in your browser (http://localhost:3000): create your administrator account and add your movies and series under Admin → Libraries. To update, download and run the installer again; your settings and data (C:\ProgramData\Vidalune) stay.

Using the PC as a server? Turn on automatic sign-in in Windows, so Vidalune runs again after a restart. Windows may warn about an unknown publisher the first time: choose More info → Run anyway.

Updating

Vidalune tells administrators when there is a new version. To update, run in the same folder:

docker compose pull
docker compose up -d

Android app

The Vidalune app for Android phones and tablets:

Download the Android app

Your Vidalune account

Link your server to a Vidalune account to find it on app.vidalune.com and in the app, also away from home. vidalune.com/account