From Fedora Project Wiki

Atomic Host


Deliver Fedora Atomic Host, an implementation of the Project Atomic pattern in several different easy to use variants.

This is a continuation and expansion of Changes/Atomic_Cloud_Image.

See also the following related changes:


  • Name: Cloud SIG / Joe Brockmeier and Colin Walters
  • Email:
  • Release notes owner:
  • Product: Atomic Host
  • Responsible WG: Cloud

Current status

Detailed Description

The original Changes/Atomic_Cloud_Image was a host system delivered just as a cloud image. This Change for Fedora 22 expands it with the following:

  • Bare metal support via Anaconda (GRUB2/x86_64 only currently)
    • Generated via rpm-ostree-toolbox, will embed content
    • This will be a minimal iso image with anaconda and a ostree to install from locally.
  • Vagrant boxes (VirtualBox and libvirt/qemu)
    • This will be two images (virtualbox and libvirt/qemu) with the same content as the above iso.
  • (DEFERRED to F23) Minimal PXE-to-Live image designed for PXE booting diskless servers, using livemedia-creator

Benefit to Fedora

Containers are a powerful and flexible way to deploy and manage server applications, with numerous benefits such as density, ease of deployment, and orchestration. The Atomic Host is optimized for running containers, coming out of the box with storage tuned for Docker and atomic upgrades.


  • Proposal owners: Maintain kickstart and tree configuration, integration with Anaconda and other tools, maintain packages in Fedora
  • Other developers: Unknown.
  • Release engineering: Will need to generate trees during the general Fedora compose process, and generate install media and cloud image based on trees.
  • Policies and guidelines: None.

Upgrade/compatibility impact

Mainline upgrades should operate unchanged.

How To Test

Test installing and running the each of the Atomic variant delivery vehicles.

User Experience

New variant of Fedora, optimized for running containers at scale.


Anaconda, Fedora Base, plus the other components listed here: RpmOstree, Kubernetes, and the Docker containers.

Contingency Plan

  • Blocks product? Yes, Atomic Host

If something fails and this product can't ship, some upgrade mechanism for Fedora 21 Atomic Cloud Image users would need to be evaluated. The simplest fallback is to tell those users to reinstall with a traditional Fedora 22 Cloud image.


Need to document how to install and manage the Atomic variant.

Release Notes

New Fedora product: Fedora Atomic Host Image, featuring Docker and tools from Project Atomic.

Docker is an easy to use interface for running application containers on Linux. Fedora is uniquely positioned to provide the best platform for Docker, since this container technology is not a security solution, but can be made reasonably secure when wrapped with SELinux. Furthermore, Fedora will provider container image content.