Installation

For now, you can either install the daemon from source, or use the released binaries.

Prerequisites

Since Cedana depends on CRIU, you will need to ensure its dependencies are installed.

Using dnf/yum (Fedora/CentOS)

apt-get install -y libnet-devel protobuf-c-devel libnl3-devel libbsd-devel libcap-devel libseccomp-devel gpgme-devel nftables-devel

Using apt (Ubuntu/Debian)

yum install -y libnet-dev libprotobuf-c-dev libnl-3-dev libbsd-dev libcap-dev libseccomp-dev libgpgme11-dev libnftables1

Build from source

Clone the cedana repository and navigate into it.

Build

make cedana

Install

make install

Try make help to see all available targets.

Download latest

You can find the latest binaries at releases. Ensure /usr/local/bin is in your PATH.

AMD64

platform=amd64
version=$(curl -s https://api.github.com/repos/cedana/cedana/releases/latest | grep tag_name | cut -d '"' -f 4)
curl -L -o cedana.tar.gz https://github.com/cedana/cedana/releases/download/$version/cedana-$platform.tar.gz
tar -xzvf cedana.tar.gz
chmod +x cedana
mv cedana /usr/local/bin/cedana
rm cedana.tar.gz

cedana --version

ARM64

platform=arm64
version=$(curl -s https://api.github.com/repos/cedana/cedana/releases/latest | grep tag_name | cut -d '"' -f 4)
curl -L -o cedana.tar.gz https://github.com/cedana/cedana/releases/download/v0.9.245/cedana-$platform.tar.gz
tar -xzvf cedana.tar.gz
chmod +x cedana
mv cedana /usr/local/bin/cedana
rm cedana.tar.gz

cedana --version

Install CRIU

To install a plugin from the online registry, you need to be authenticated. See plugins for more information.

A modified version of CRIU is shipped as a plugin for Cedana, so you don't need to install it separately. You can simply do:

sudo cedana plugin install criu

This version of CRIU is not a requirement for Cedana, but it is recommended for certain features, such as checkpoint/restore streamer.

To install CRIU independently, see the CRIU installation guide.

Start the daemon

The daemon requires root privileges for checkpoint/restore operations. Check the CLI reference for all options.

Direct

You can directly start the daemon with:

sudo cedana daemon start

Systemd

If you're a systemd user, you may also install it as a service (if built from source):

make install-systemd

Try make help to see all available targets.

Health check the daemon

The daemon can be health checked to ensure it fully supports the system and is ready to accept requests. See health checks for more information.