Skip to content

Installation on CentOS/RHEL/Fedora/SUSE

You will need Docker to work, installation instructions are available on the official site.

Quick install Docker

bash <(curl -sSL

Manual install

When upgrading to a new version, first stop the server

sudo systemctl stop yucca

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

Run arch to find out your architecture

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

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

We configure the network filter:

sudo firewall-cmd --permanent --new-service=yucca
sudo firewall-cmd --permanent --service=yucca --add-port=9910/tcp
sudo firewall-cmd --permanent --zone=public --add-service=yucca
sudo firewall-cmd --reload

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