Page MenuHomeVyOS Platform

Document the process to build and test kernel images
Closed, ResolvedPublic


The process and requirements (current) to compile and produce bootable kernel images should be documented. Any tools used (ex. qemu) and methods to build readily bootable ISO images, or disk images to supply as base fielsystem. Having the ability to product a raw filesystem image would also help test user-land changes on their own.

At the moment there is no documentation for this process.

Suggested coverage:

  1. Host/development system requirements for kernel testing.
  2. Bootstrapping of the build environment
  3. Preferred patching approach, connections to repositories, etc.
  4. Where to find things: kconfigs, etc.
  5. Required/core kernel options needed regardless of any changes.
  6. Steps to build a kernel package and a standalone image.
  7. Examples of building or loading a VyOS userland filesystem image together with the test kernel.


Difficulty level
Unknown (require assessment)
Why the issue appeared?
Will be filled on close

Event Timeline

lh created this object in space S1 VyOS Public.
syncer triaged this task as Normal priority.Jul 20 2018, 12:40 PM
syncer changed the visibility from "Subscribers" to "Public (No Login Required)".
syncer changed the task status from Open to On hold.Oct 18 2018, 5:44 AM
syncer added a subscriber: syncer.

no progress here, either must be dropped or picked up by someone

zsdc claimed this task.
zsdc added a subscriber: zsdc.

Kernel related part is located here:
The rest is here:

If someone wants to improve docs, feel free to do this.