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.

Submitting 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!