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 it's dependencies are installed. For Ubuntu, you can install them with:

apt-get install -y python3-protobuf libnet1 libnftables1 libnl-3-200 libprotobuf-c1 iptables

Build from source

To build:

make build

To install:

make install

To build and install (with all plugins):

make all

Try make help to see all available targets.

Download from releases

Download the latest release from the releases.

curl -L -o cedana.tar.gz https://github.com/cedana/cedana/releases/download/v${CEDANA_VERSION}/cedana_${CEDANA_VERSION}_linux_amd64.tar.gz
tar -xzf cedana.tar.gz cedana
mv cedana /usr/local/bin/cedana
rm cedana.tar.gz

Install CRIU

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.

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

To install CRIU independently, see the CRIU installation guide.

Start the daemon

You can directly start the daemon with:

make start

The daemon requires root privileges for checkpoint/restore operations.

If you're a systemd user, you may also install it as a service:

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.