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
armv6l armv6
armv7l armv7
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
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

Сomplete list of available versions:

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

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