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
armv6l armv6
armv7l armv7
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.6.0-1_amd64.deb
sudo dpkg -i yucca_0.6.0-1_arm.deb
sudo dpkg -i yucca_0.6.0-1_arm64.deb
sudo dpkg -i yucca-enterprise_0.6.0-1_amd64.deb
sudo dpkg -i yucca-enterprise_0.6.0-1_arm.deb
sudo dpkg -i yucca-enterprise_0.6.0-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
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 and 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
wget -q --show-progress -O ffmpeg-4.4-linux-amd64.tar.gz
wget -q --show-progress -O ffmpeg-4.4-linux-amd64.tar.gz.md5
md5sum -c ffmpeg-4.4-linux-amd64.tar.gz.md5
tar -xzf ffmpeg-4.4-linux-amd64.tar.gz ffmpeg
tar -xzf ffmpeg-4.4-linux-amd64.tar.gz ffprobe
rm -rf ffmpeg-4.4-linux-amd64.tar.gz ffmpeg-4.4-linux-amd64.tar.gz.md5
cd /opt/yucca/ffmpeg
wget -q --show-progress -O ffmpeg-4.4-linux-armv6.tar.gz
wget -q --show-progress -O ffmpeg-4.4-linux-armv6.tar.gz.md5
md5sum -c ffmpeg-4.4-linux-armv6.tar.gz.md5
tar -xzf ffmpeg-4.4-linux-armv6.tar.gz ffmpeg
tar -xzf ffmpeg-4.4-linux-armv6.tar.gz ffprobe
rm -rf ffmpeg-4.4-linux-armv6.tar.gz ffmpeg-4.4-linux-armv6.tar.gz.md5
cd /opt/yucca/ffmpeg
wget -q --show-progress -O ffmpeg-4.4-linux-armv7.tar.gz
wget -q --show-progress -O ffmpeg-4.4-linux-armv7.tar.gz.md5
md5sum -c ffmpeg-4.4-linux-armv7.tar.gz.md5
tar -xzf ffmpeg-4.4-linux-armv7.tar.gz ffmpeg
tar -xzf ffmpeg-4.4-linux-armv7.tar.gz ffprobe
rm -rf ffmpeg-4.4-linux-armv7.tar.gz ffmpeg-4.4-linux-armv7.tar.gz.md5
cd /opt/yucca/ffmpeg
wget -q --show-progress -O ffmpeg-4.4-linux-arm64.tar.gz
wget -q --show-progress -O ffmpeg-4.4-linux-arm64.tar.gz.md5
md5sum -c ffmpeg-4.4-linux-arm64.tar.gz.md5
tar -xzf ffmpeg-4.4-linux-arm64.tar.gz ffmpeg
tar -xzf ffmpeg-4.4-linux-arm64.tar.gz ffprobe
rm -rf ffmpeg-4.4-linux-arm64.tar.gz ffmpeg-4.4-linux-arm64.tar.gz.md5

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