π©Ί Diagnostics
The Diagnostics feature collects detailed system information and bundles it into a single downloadable archive. This file is useful for troubleshooting issues and sharing system details with the MOS community or support.
π₯ Creating a Diagnostics Fileβ
- Navigate to Settings β System Configuration β Diagnostics
- Click on Diagnostics β the file is created immediately and the download starts automatically
- A notification briefly confirms the file location:
Diagnostics created: /boot/diagnostics/MOS_<date>_<time>.tar.gz

The diagnostics file is saved to /boot/diagnostics/ on the system. Old diagnostics files are not automatically deleted.
π¦ Archive Structureβ
The diagnostics archive is a .tar.gz file named MOS_YYYY-MM-DD_HH-MM.tar.gz with the following structure:
π¦ Archive Structureβ
The diagnostics archive is a .tar.gz file named MOS_YYYY-MM-DD_HH-MM.tar.gz with the following structure:
MOS_YYYY-MM-DD_HH-MM.tar.gz
βββ mos-release.json # MOS version & installed packages
βββ uname.txt # Kernel version
βββ errors.txt # Errors encountered during diagnostics collection
βββ boot_tree.txt # Full directory tree of /boot
βββ api/ # Current API state (runtime data)
β βββ cron.json # Active cron jobs
β βββ disks.json # Detected disks and their status
β βββ pools.json # Storage pool status
β βββ shares.json # Active shares
βββ config/ # System configuration files
β βββ docker.json # Docker service configuration
β βββ lxc.json # LXC service configuration
β βββ network.json # Network configuration
β βββ pools.json # Storage pool configuration
β βββ remotes.json # Remote mount configuration
β βββ shares.json # Share configuration
β βββ vm.json # VM service configuration
β βββ system/ # Additional system config
β βββ cron.json # Cron configuration
β βββ hub.json # MOS Hub configuration
β βββ proxy.json # Proxy configuration
β βββ smart.json # S.M.A.R.T. configuration
β βββ zram.json # ZRAM configuration
β βββ iscsi/ # iSCSI initiator & target config
β βββ lxc/ # LXC default container config
β βββ nut/ # NUT (UPS) configuration
βββ grub/
β βββ grub.cfg # GRUB bootloader configuration
βββ logs/ # System logs
β βββ api.txt # MOS API log
β βββ boot.txt # Boot log
β βββ syslog.txt # System syslog
βββ nfs/
β βββ exports.txt # Active NFS exports
βββ samba/
β βββ testparm.txt # Samba configuration test output
βββ system/ # Hardware & system info
βββ aspm.txt # PCIe ASPM power management info
βββ bios.txt # BIOS/UEFI information
βββ cpu.txt # CPU details
βββ cron.txt # Active cron jobs (system level)
βββ df.txt # Disk space usage
βββ dmesg.txt # Kernel ring buffer messages
βββ dri.txt # DRM/GPU driver info
βββ lspci.txt # PCI device list
βββ lsusb.txt # USB device list
βββ memory.txt # Memory/RAM information
βββ motherboard.txt # Motherboard/DMI information
βββ nginx.conf # NGINX webserver configuration
π File Descriptionsβ
Root Levelβ
| File | Description |
|---|---|
mos-release.json | MOS version, build date, frontend/API versions, and a full list of all installed packages with their versions |
uname.txt | Kernel version and build info (e.g. Linux MOS 6.18.22-mos) |
errors.txt | Any errors that occurred while generating the diagnostics β useful to check first if something seems missing |
boot_tree.txt | Complete directory tree of the /boot partition |
api/ β Runtime Stateβ
Contains the live state of the system as reported by the MOS API at the time of collection.
| File | Description |
|---|---|
cron.json | Currently configured cron jobs |
disks.json | All detected disks, their size, type, and health status |
pools.json | Storage pool status including filesystem and mount state |
shares.json | All configured SMB/NFS shares |
config/ β Configuration Filesβ
Contains the raw configuration files from /boot/config/. These are the persistent settings of your MOS installation.
| File | Description |
|---|---|
docker.json | Docker daemon settings (storage path, network driver, etc.) |
lxc.json | LXC service settings |
network.json | Network interface configuration (IPs, bonds, VLANs) |
pools.json | Storage pool definitions |
remotes.json | Remote mount definitions |
shares.json | Share definitions (SMB/NFS) |
vm.json | VM service settings (directory, IOMMU, VirtIO) |
system/smart.json | S.M.A.R.T. monitoring configuration |
system/zram.json | ZRAM swap configuration |
system/hub.json | MOS Hub settings |
system/proxy.json | Proxy settings |
system/iscsi/ | iSCSI initiator and target configuration |
system/lxc/ | LXC default container configuration |
system/nut/ | NUT (Network UPS Tools) configuration |
logs/ β System Logsβ
| File | Description |
|---|---|
api.txt | MOS API log β helpful for diagnosing WebUI or API issues |
boot.txt | Boot log β shows what happened during the last system startup |
syslog.txt | Full system syslog β the most comprehensive log for general issues |
system/ β Hardware Informationβ
| File | Description |
|---|---|
bios.txt | BIOS/UEFI vendor, version, and release date |
motherboard.txt | Motherboard manufacturer and model |
cpu.txt | CPU model, cores, threads, and frequency |
memory.txt | RAM size, type, and slot information |
lspci.txt | All PCI/PCIe devices (GPUs, NICs, controllers, etc.) |
lsusb.txt | All connected USB devices |
dmesg.txt | Kernel messages β useful for detecting hardware errors or driver issues |
df.txt | Disk space usage across all mounted filesystems |
dri.txt | GPU/DRM driver information |
aspm.txt | PCIe Active State Power Management info |
nginx.conf | NGINX reverse proxy configuration used by MOS |
cron.txt | System-level cron jobs |
Otherβ
| File/Folder | Description |
|---|---|
grub/grub.cfg | GRUB bootloader configuration β shows kernel boot parameters |
nfs/exports.txt | Active NFS export table |
samba/testparm.txt | Output of testparm β validates Samba configuration |
β οΈ Privacy Noticeβ
The diagnostics archive contains system configuration and log data. Before sharing the file publicly or with third parties, review its contents and consider redacting sensitive information such as:
- IP addresses and network configuration (
config/network.json) - Share paths and names (
config/shares.json) - API tokens or credentials (these are not included by default, but check
boot_tree.txtfor reference) - UPS usernames/passwords (
config/system/nut/)
When reporting a bug or asking for help on Discord, attaching the diagnostics file greatly helps the team identify the issue faster.
Parts of this documentation were created with the assistance of AI tools. All AI-generated content has undergone review, but it may still contain inaccuracies, omissions, or outdated information.