Skip to content

Installation on Debian/Ubuntu

We recommend installing Yucca on an Ubuntu Long Term Support (LTS) operating system such as 18.04 and older. In this case, work is possible on any other Linux distribution. You will also need Docker to work, installation instructions are available on the official site.

Quick install Docker

bash <(curl -sSL

Installation via the package manager

When upgrading to a new version, first stop the server

sudo systemctl stop yucca

Run arch to find out your architecture

Output arch Notation in the documentation
x86_64 amd64
armv7l arm
aarch64 arm64

Download and install the .deb package of the required version and architecture, a complete list of available versions:

sudo dpkg -i yucca_0.5.1-1_amd64.deb
sudo dpkg -i yucca_0.5.1-1_arm.deb
sudo dpkg -i yucca_0.5.1-1_arm64.deb

After starting the WEB-interface will be available at http://ip-your-server:9910

Manual installation

Let's start by creating a user and a group, then add a new user to the docker group to be able to work with Docker containers:

sudo useradd -M -U -s /bin/false -b /opt/yucca -G docker yucca

Create a directory for installation and go to it, download the latest version of Yucca:

sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget -O /opt/yucca/yucca
sudo chmod +x /opt/yucca/yucca
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget -O /opt/yucca/yucca
sudo chmod +x /opt/yucca/yucca
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget -O /opt/yucca/yucca
sudo chmod +x /opt/yucca/yucca

Installation ffmpeg и ffprobe:

FFmpeg version not lower than 4.0

You can use the static assembly we suggested, or any other, provided that ffmpeg and ffprobe are resolved into env by a standard name

cd /opt/yucca/ffmpeg
sudo wget
sudo wget
md5sum -c ffmpeg-4.3.1-amd64-static.tar.xz.md5
sudo tar -xJvf ffmpeg-4.3.1-amd64-static.tar.xz ffmpeg-4.3.1-amd64-static/ffmpeg --strip-components 1
sudo tar -xJvf ffmpeg-4.3.1-amd64-static.tar.xz ffmpeg-4.3.1-amd64-static/ffprobe --strip-components 1
sudo rm -f ffmpeg-4.3.1-amd64-static.tar.xz*
cd /opt/yucca/ffmpeg
sudo wget
sudo wget
md5sum -c ffmpeg-4.3.1-armhf-static.tar.xz.md5
sudo tar -xJvf ffmpeg-4.3.1-armhf-static.tar.xz ffmpeg-4.3.1-armhf-static/ffmpeg --strip-components 1
sudo tar -xJvf ffmpeg-4.3.1-armhf-static.tar.xz ffmpeg-4.3.1-armhf-static/ffprobe --strip-components 1
sudo rm -f ffmpeg-4.3.1-armhf-static.tar.xz*
cd /opt/yucca/ffmpeg
sudo wget
sudo wget
md5sum -c ffmpeg-4.3.1-arm64-static.tar.xz.md5
sudo tar -xJvf ffmpeg-4.3.1-arm64-static.tar.xz ffmpeg-4.3.1-arm64-static/ffmpeg --strip-components 1
sudo tar -xJvf ffmpeg-4.3.1-arm64-static.tar.xz ffmpeg-4.3.1-arm64-static/ffprobe --strip-components 1
sudo rm -f ffmpeg-4.3.1-arm64-static.tar.xz*

Generating a default configuration file:

sudo /opt/yucca/yucca server --config emtpy --show-config | sed 's|data_dir = ""|data_dir = "/opt/yucca/data"|' > /opt/yucca/yucca.toml

We set the owner and access rights:

sudo chown -R yucca:yucca /opt/yucca
sudo chmod -R 2775 /opt/yucca

Create a systemd unit file and update the list of daemons for the changes to take effect:

sudo tee /lib/systemd/system/yucca.service <<EOF
Description=Yucca Stream <>
Documentation= docker.service

ExecStart=/opt/yucca/yucca server --config /opt/yucca/yucca.toml

ExecStop=/bin/kill -s SIGTERM $MAINPID


sudo systemctl daemon-reload

Now you can start the server and test it

sudo systemctl enable yucca
sudo systemctl start yucca

After launch, the Web interface will be available at http://ip-your-server:9910