Home

Installation Guide

These instructions describe how the LXC/LXD packages built in the ganto/lxc4 COPR project from the spec files hosted in this repository can be used to run LXC or LXD on a Fedora Linux host.

IMPORTANT

These packages are not official Fedora packages and they are only minimally functionally tested. Use them at your own risk and don't forget to create a backup before you perform an update. If you find an issue with the packages, please open a Github issue in this repository. However I won't provide any general LXC/LXD support. For this please check https://discuss.linuxcontainers.org/

Prerequisites

Currently the packages are available for Fedora 32/33/34/Rawhide and the x86_64, aarch64 and armhfp architecture.

Enable the COPR repository:

# dnf copr enable ganto/lxc4

LXC

Install LXC including liblxc and the lxc-* command line utilities:

# dnf install lxc

If you already have LXC installed from the Fedora repository run:

# dnf update lxc

IMPORTANT

This will replace the official lxc packages in case you had previously installed them from the Fedora repositories. However, the release numbers of the COPR packages are chosen in way, that the official lxc packages should replace the COPR packages again once the same (or newer) version is provided by Fedora.

LXD

Install the LXD daemon and the lxc command line client:

# dnf install lxd

This is enough to run the traditional Linux containers. However LXD is also able to manage virtual machines (as an alternative to libvirt). For this additional packages are needed (see below).

Virtual Machine Support

If you want to run virtual machines with LXD additional packages are required:

# dnf install lxd-agent edk2-ovmf genisoimage qemu-img qemu-system-x86-core

On Fedora 33 additionally the following package is required:

# dnf install qemu-device-usb-redirect

On Fedora 34 the QEMU spice packaging was changed a bit therefore another additional set of packages is required:

# dnf install qemu-char-spice qemu-device-usb-redirect qemu-device-display-virtio-vga qemu-device-display-virtio-gpu

IMPORTANT

If you installed the lxd-agent package on a VM that itself is managed through LXD then you need to re-enable the systemd service lxd-agent.service otherwise you won't be able to access the VM after a reboot via lxc shell anymore:

systemctl enable lxd-agent.service

Getting started

• Getting started with LXD on Fedora

For more details please check the official documentation that can also be found in the lxd-doc RPM package.