Reporting and reviewing bugs

MAAS bug reports live on Launchpad. Before you dive into reporting, let’s make sure your report is top-notch for swift triage and resolution.

Ready your info

Preparation is key. Have these details ready:

  1. Bug summary: Be concise. Think:
    • “MAAS PXE boot fails on IBM LPAR as KVM host”
  2. Version and build:
    • Snap users: snap list maas
    • Debian package users: apt list maas
  3. Interface used: UI? CLI? API? Specify.
  4. What happened: Describe the unexpected behaviour. Keep it crisp.
  5. Steps to reproduce: Step-by-step actions leading to the problem.
  6. Screenshots: Only if they clarify.
  7. Logfiles: Especially maas.log, regiond.log, rackd.log. Depending on your installation:
    • Snap: /var/snap/maas/common/log/
    • Debian Package: /var/log/maas/

Use a text editor. Keep these details at hand.

Submit the bug

  1. Start here: Launchpad bug report page^
  2. Summary: Input your concise summary.
  3. Details: Paste the prepared info into “Further information”.
  4. Attachments: Add screenshots and logfiles. Describe them.
  5. Submit: Click “Submit Bug Report”.

For clarity, you can view this sample bug.

Happy reporting!


Last updated a month ago.