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 apt (Ubuntu/Debian)

apt-get install -y libnet-dev libprotobuf-c-dev libnl-3-dev libbsd-dev libcap-dev libseccomp-dev libgpgme11-dev libnftables-dev

Using dnf/yum (Fedora/CentOS)

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

Download latest release

Cedana is supported on both linux/amd64 and linux/arm64 platforms.

Using public installer:

curl -fsSL https://github.com/cedana/cedana/releases/latest/download/install-release.sh | sudo -E bash

Using authenticated installer (see Authentication):

export CEDANA_URL=https://myorg.cedana.ai/v1
export CEDANA_AUTH_TOKEN=your_auth_token

curl -fsSL ${CEDANA_URL}/install?version=latest -H "Authorization: Bearer ${CEDANA_AUTH_TOKEN}" | sudo -E bash

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

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.

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-service

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.