Skip to content

Manual installation for other Linux

If you need the help of a specialist to solve this or any other problem, study our terms technical support.

Manual installation

Run arch to find out your architecture

Output of arch Designation in the documentation
x86_64 amd64
x86 386
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 https://releases.yucca.app/v0.9.3/yucca_0.9.3_linux_amd64.tar.gz
sudo wget https://releases.yucca.app/v0.9.3/yucca_0.9.3_checksums.txt
sha256sum -c yucca_0.9.3_checksums.txt --ignore-missing
sudo tar -xzvf yucca_0.9.3_linux_amd64.tar.gz
sudo rm -f yucca_0.9.3_linux_amd64.tar.gz
)
(
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget https://releases.yucca.app/v0.9.3/yucca_0.9.3_linux_368.tar.gz
sudo wget https://releases.yucca.app/v0.9.3/yucca_0.9.3_checksums.txt
sha256sum -c yucca_0.9.3_checksums.txt --ignore-missing
sudo tar -xzvf yucca_0.9.3_linux_368.tar.gz
sudo rm -f yucca_0.9.3_linux_368.tar.gz
)
(
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget https://releases.yucca.app/v0.9.3/yucca_0.9.3_linux_armv6.tar.gz
sudo wget https://releases.yucca.app/v0.9.3/yucca_0.9.3_checksums.txt
sha256sum -c yucca_0.9.3_checksums.txt --ignore-missing
sudo tar -xzvf yucca_0.9.3_linux_armv6.tar.gz
sudo rm -f yucca_0.9.3_linux_armv6.tar.gz
)
(
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget https://releases.yucca.app/v0.9.3/yucca_0.9.3_linux_armv7.tar.gz
sudo wget https://releases.yucca.app/v0.9.3/yucca_0.9.3_checksums.txt
sha256sum -c yucca_0.9.3_checksums.txt --ignore-missing
sudo tar -xzvf yucca_0.9.3_linux_armv7.tar.gz
sudo rm -f yucca_0.9.3_linux_armv7.tar.gz
)
(
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget https://releases.yucca.app/v0.9.3/yucca_0.9.3_linux_arm64.tar.gz
sudo wget https://releases.yucca.app/v0.9.3/yucca_0.9.3_checksums.txt
sha256sum -c yucca_0.9.3_checksums.txt --ignore-missing
sudo tar -xzvf yucca_0.9.3_linux_arm64.tar.gz
sudo rm -f yucca_0.9.3_linux_arm64.tar.gz
)
(
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget https://releases.yucca.app/v0.9.3/yucca-ent_0.9.3_linux_amd64.tar.gz
sudo wget https://releases.yucca.app/v0.9.3/yucca_0.9.3_checksums.txt
sha256sum -c yucca_0.9.3_checksums.txt --ignore-missing
sudo tar -xzvf yucca-ent_0.9.3_linux_amd64.tar.gz
sudo rm -f yucca-ent_0.9.3_linux_amd64.tar.gz
)
(
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget https://releases.yucca.app/v0.9.3/yucca-ent_0.9.3_linux_386.tar.gz
sudo wget https://releases.yucca.app/v0.9.3/yucca_0.9.3_checksums.txt
sha256sum -c yucca_0.9.3_checksums.txt --ignore-missing
sudo tar -xzvf yucca-ent_0.9.3_linux_386.tar.gz
sudo rm -f yucca-ent_0.9.3_linux_386.tar.gz
)
(
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget https://releases.yucca.app/v0.9.3/yucca-ent_0.9.3_linux_armv6.tar.gz
sudo wget https://releases.yucca.app/v0.9.3/yucca_0.9.3_checksums.txt
sha256sum -c yucca_0.9.3_checksums.txt --ignore-missing
sudo tar -xzvf yucca-ent_0.9.3_linux_armv6.tar.gz
sudo rm -f yucca-ent_0.9.3_linux_armv6.tar.gz
)
(
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget https://releases.yucca.app/v0.9.3/yucca-ent_0.9.3_linux_armv7.tar.gz
sudo wget https://releases.yucca.app/v0.9.3/yucca_0.9.3_checksums.txt
sha256sum -c yucca_0.9.3_checksums.txt --ignore-missing
sudo tar -xzvf yucca-ent_0.9.3_linux_armv7.tar.gz
sudo rm -f yucca-ent_0.9.3_linux_armv7.tar.gz
)
(
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget https://releases.yucca.app/v0.9.3/yucca-ent_0.9.3_linux_arm64.tar.gz
sudo wget https://releases.yucca.app/v0.9.3/yucca_0.9.3_checksums.txt
sha256sum -c yucca_0.9.3_checksums.txt --ignore-missing
sudo tar -xzvf yucca-ent_0.9.3_linux_arm64.tar.gz
sudo rm -f yucca-ent_0.9.3_linux_arm64.tar.gz
)

Full list of available versions: https://releases.yucca.app/

Generating a configuration file with default values:

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

Create a user and set the owner and access rights:

(
sudo groupadd --gid 642 --force yucca
sudo useradd --system -u 642 --no-create-home --shell /bin/false --home-dir /opt/yucca --gid yucca yucca
sudo chown -R yucca:yucca /opt/yucca
sudo chmod -R 2775 /opt/yucca
)

Optional you can specify your path to save the archive by defining the parameter alloc_dir, first create the desired directory, example:

In your case, the path may be different!

(
sudo mkdir -p /volume1/yucca/alloc_dir
sudo chown -R yucca:yucca /volume1/yucca/alloc_dir
sudo chmod -R 2775 /volume1/yucca/alloc_dir
sed -i 's|alloc_dir = ""|alloc_dir = "/volume1/yucca/alloc_dir"|' /opt/yucca/yucca.toml
)

Make sure everything is correct:

cat /opt/yucca/yucca.toml

Systemd autorun

Creating a systemd unit file:

sudo tee /lib/systemd/system/yucca.service <<EOF
[Unit]
Description=Yucca https://yucca.app
Documentation=https://docs.yucca.app
After=syslog.target network.target remote-fs.target nss-lookup.target

[Service]
Type=simple
User=yucca
Group=yucca
SyslogIdentifier=yucca
PIDFile=/run/yucca.pid
LimitNOFILE=65535
WorkingDirectory=/opt/yucca
ExecStart=/opt/yucca/yucca server --config /opt/yucca/yucca.toml
ExecStop=/bin/kill -s SIGTERM $MAINPID
Restart=on-failure
RestartSec=10s

[Install]
WantedBy=multi-user.target
EOF

Now you can start the server and check the operation:

sudo systemctl daemon-reload
sudo systemctl enable yucca
sudo systemctl start yucca

Upstart autorun (Synology NAS)

Creating an autorun script Upstart init:

sudo tee /etc/init/yucca.conf <<EOF
description "Yucca https://yucca.app"
author "Yucca"

start on filesystem or runlevel [2345]
stop on runlevel [!2345]

respawn
respawn limit 10 10
setuid yucca
setgid yucca
chdir /opt/yucca
limit nofile 65535 65535
script
    exec /opt/yucca/yucca server --config /opt/yucca/yucca.toml
end script

EOF

Update the Upstart configuration, check, run:

sudo initctl reload-configuration
sudo initctl list | grep yucca
sudo initctl start yucca

OpenRC/sysvinit autorun

There is no instruction, you can offer it.

Checking the work

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

Additional