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 https://get.docker.com)

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 https://get.yucca.app/v0.6.0/linux_amd64/yucca -O /opt/yucca/yucca
sudo chmod +x /opt/yucca/yucca
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget https://get.yucca.app/v0.6.0/linux_arm/yucca -O /opt/yucca/yucca
sudo chmod +x /opt/yucca/yucca
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget https://get.yucca.app/v0.6.0/linux_arm64/yucca -O /opt/yucca/yucca
sudo chmod +x /opt/yucca/yucca
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget https://ent-get.yucca.app/v0.6.0/linux_amd64/yucca -O /opt/yucca/yucca
sudo chmod +x /opt/yucca/yucca
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget https://ent-get.yucca.app/v0.6.0/linux_arm/yucca -O /opt/yucca/yucca
sudo chmod +x /opt/yucca/yucca
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget https://ent-get.yucca.app/v0.6.0/linux_arm64/yucca -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 https://get.yucca.app/ffmpeg/4.4/ffmpeg-4.4-amd64-static.tar.xz
sudo wget https://get.yucca.app/ffmpeg/4.4/ffmpeg-4.4-amd64-static.tar.xz.md5
md5sum -c ffmpeg-4.4-amd64-static.tar.xz.md5
sudo tar -xJvf ffmpeg-4.4-amd64-static.tar.xz ffmpeg-4.4-amd64-static/ffmpeg --strip-components 1
sudo tar -xJvf ffmpeg-4.4-amd64-static.tar.xz ffmpeg-4.4-amd64-static/ffprobe --strip-components 1
sudo rm -f ffmpeg-4.4-amd64-static.tar.xz*
cd /opt/yucca/ffmpeg
sudo wget https://get.yucca.app/ffmpeg/4.4/ffmpeg-4.4-armhf-static.tar.xz
sudo wget https://get.yucca.app/ffmpeg/4.4/ffmpeg-4.4-armhf-static.tar.xz.md5
md5sum -c ffmpeg-4.4-armhf-static.tar.xz.md5
sudo tar -xJvf ffmpeg-4.4-armhf-static.tar.xz ffmpeg-4.4-armhf-static/ffmpeg --strip-components 1
sudo tar -xJvf ffmpeg-4.4-armhf-static.tar.xz ffmpeg-4.4-armhf-static/ffprobe --strip-components 1
sudo rm -f ffmpeg-4.4-armhf-static.tar.xz*
cd /opt/yucca/ffmpeg
sudo wget https://get.yucca.app/ffmpeg/4.4/ffmpeg-4.4-arm64-static.tar.xz
sudo wget https://get.yucca.app/ffmpeg/4.4/ffmpeg-4.4-arm64-static.tar.xz.md5
md5sum -c ffmpeg-4.4-arm64-static.tar.xz.md5
sudo tar -xJvf ffmpeg-4.4-arm64-static.tar.xz ffmpeg-4.4-arm64-static/ffmpeg --strip-components 1
sudo tar -xJvf ffmpeg-4.4-arm64-static.tar.xz ffmpeg-4.4-arm64-static/ffprobe --strip-components 1
sudo rm -f ffmpeg-4.4-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
[Unit]
Description=Yucca Stream <https://yucca.app>
Documentation=https://docs.yucca.app
After=syslog.target network.target remote-fs.target nss-lookup.target docker.service

[Service]
AmbientCapabilities=CAP_SYS_ADMIN
Type=simple
User=yucca
Group=yucca
SyslogIdentifier=yucca
PIDFile=/var/run/yucca.pid
ExecStart=/opt/yucca/yucca server --config /opt/yucca/yucca.toml

ExecStop=/bin/kill -s SIGTERM $MAINPID
Restart=on-failure

[Install]
WantedBy=multi-user.target
EOF

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