Skip to content

Manual installation for other Linux


If you need expert help with this or any other issue, please see our terms and conditions technical support.

Use PostgreSQL, with a large number of cameras

When operating in production environments with a large number of cameras and motion detection enabled, we recommend using PostgreSQL as a more productive database. How to install and configure usage, read here

Which version should I choose?

There are 2 editions of Yucca

The completely free version does not require a license and does not contain advanced features.

Contains advanced features and requires the purchase and use of a license.
If you have a Plus or Enterprise license, install yucca with the ent postfix.

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
sudo tar -xzvf yucca_linux_amd64.tar.gz
sudo rm -f yucca_linux_amd64.tar.gz
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget
sudo tar -xzvf yucca_linux_arm.tar.gz
sudo rm -f yucca_linux_arm.tar.gz
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget
sudo tar -xzvf yucca_linux_arm64.tar.gz
sudo rm -f yucca_linux_arm64.tar.gz
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget
sudo tar -xzvf yucca-ent_linux_amd64.tar.gz
sudo rm -f yucca-ent_linux_amd64.tar.gz
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget
sudo tar -xzvf yucca-ent_linux_arm.tar.gz
sudo rm -f yucca-ent_linux_arm.tar.gz
sudo mkdir -p /opt/yucca/ffmpeg
cd /opt/yucca
sudo wget
sudo tar -xzvf yucca-ent_linux_arm64.tar.gz
sudo rm -f yucca-ent_linux_arm64.tar.gz

Full list of available versions

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

ExecStart=/opt/yucca/yucca server --config /opt/yucca/yucca.toml
ExecStop=/bin/kill -s SIGTERM $MAINPID


Now you can start the server and check the operation:

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

Upstart autorun

For example, used in Synology NAS

Creating an autorun script Upstart init:

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

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

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


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