Page MenuHomeVyOS Platform

KDUMP support for VyOS
In progress, NormalPublic

Description

Add native kdump (kernel crash dump) support to VyOS, configurable via the VyOS CLI, to allow kernel panic analysis on production devices.
The following were confirmed unavailable or non-functional:

- kdump: not configured, /var/crash/ does not exist
- pstore/EFI: mounted but empty after panic
- generate tech-support archive: cannot capture post-panic state
- /var/core/: only captures userspace process crashes, not kernel panics

Verified on VyOS 1.5.0 (circinus), kernel 6.6.128-vyos:

# kexec is present in the kernel:
/proc/sys/kernel/kexec_load_disabled       ### exists
/proc/sys/kernel/kexec_load_limit_panic    ### exists
/proc/sys/kernel/kexec_load_limit_reboot   ### exists

# But crash dump is not configured:
/sys/kernel/kexec_crash_size               ### 0 (no memory reserved)
/sys/kernel/kexec_crash_loaded             ### 0 (no crash kernel loaded)
/var/crash/                                ### does not exist
kdump-tools package                        ### not installed

# Missing kernel config options:
CONFIG_CRASH_DUMP                          ### likely not set
CONFIG_PROC_VMCORE                         ### likely not set

# kexec syscall is available:
CONFIG_KEXEC                               ### present

This means the kernel already has the foundation (CONFIG_KEXEC). The remaining work is to enable CONFIG_CRASH_DUMP, CONFIG_PROC_VMCORE, install kdump-tools, and expose configuration via the VyOS CLI.

REQUESTED IMPLEMENTATION

KERNEL BUILD
Enable the following options in x86_64_vyos_defconfig:

CONFIG_KEXEC=y # already present CONFIG_CRASH_DUMP=y # required — enables kdump
CONFIG_PROC_VMCORE=y # required — exposes /proc/vmcore CONFIG_DEBUG_INFO=y # required — for crash utility analysis

PACKAGE
Include kdump-tools and makedumpfile in the VyOS base image:

ii kdump-tools
ii makedumpfile
ii kexec-tools

Suggested VyOS CLI commands

Configuration mode commands

Enable kdump with memory reservation

set system kdump enable

Set memory reservation for crash kernel (default: auto*)

set system kdump memory '256M'

Set local dump path

set system kdump dump-path '/var/crash'

Optional: send dump to remote host via SSH

set system kdump remote-host '192.0.2.10'
set system kdump remote-path '/dumps/vyos'

Operational mode commands:

Show kdump status

show system kdump

Show existing crash dumps

show system kdump dumps

Suggested output of show system kdump:

kdump status: enabled
crash kernel: loaded
memory reserved: 256M
dump path: /var/crash
last dump: 2026-05-12 10:30:01

GRUB INTEGRATION
Automatically inject the crashkernel= parameter into the VyOS GRUB configuration when kdump is enabled via CLI, without requiring manual edits to grub.cfg:

crashkernel=256M

CONFIG_KEXEC is already present and smoke-tested in the VyOS kernel (T8108). The delta to full kdump support is minimal, primarily CONFIG_CRASH_DUMP and CONFIG_PROC_VMCORE.

The kernel boot parameter infrastructure (T5979) and the kernel upgrade to 6.18 (T8147) are both resolved, meaning all prerequisites for this feature are now in place.

Details

Version
1.5.0
Is it a breaking change?
Perfectly compatible
Issue type
Feature (new functionality)

Event Timeline

c.faria triaged this task as Normal priority.
c.faria created this object in space S1 VyOS Public.
c.faria created this object with edit policy "All Users".
o.kuchmystyi changed the task status from Open to In progress.Mon, Jun 8, 8:14 AM