🐛 ArxOS Bug Reports & Issues

Official Bug Tracking & Issue Management for ArxOS
Report Bugs • Request Features • Track Fixes • Community Support

---

🎯 Purpose

This repository is the official bug tracker for ArxOS v2026.1 ~ Venus and all future releases. Whether you've encountered a bug, have a feature suggestion, or need help troubleshooting, this is the place to report it.

Why a separate repo? Keeping bugs and issues separate from the main codebase makes it easier to track, prioritize, and resolve problems without cluttering the main repository.

---

📋 What to Report Here

✅ DO Report:

• 🐛 Bugs & Errors

  • System crashes or freezes
  • Package installation failures
  • Hardware compatibility issues
  • Performance problems
  • GUI/Desktop environment glitches
  • Script or tool malfunctions
  • Boot or installation issues

• 💡 Feature Requests

  • New tool suggestions
  • Workflow improvements
  • Desktop customization ideas
  • Automation script requests
  • Documentation improvements

• 📚 Documentation Issues

  • Unclear instructions
  • Missing information
  • Outdated guides
  • Typos or errors in docs

• 🔧 Enhancement Suggestions

  • Performance optimizations
  • User experience improvements
  • Configuration suggestions
  • Integration requests

❌ DON'T Report:

• General Linux questions - Use Arch forums or r/archlinux
• How-to questions - Check our documentation first
• BlackArch tool bugs - Report to BlackArch project
• Upstream package bugs - Report to package maintainers
• Security vulnerabilities - Email contact.arxos@proton.me privately

---

🚀 Before You Report

Check First

Before creating a new issue, please:

1. Search existing issues - Your problem might already be reported
2. Check the documentation - ArxOS README
3. Update your system - Run arxos-update or sudo pacman -Syu
4. Try basic troubleshooting - Reboot, clear cache, check logs
5. Read the FAQ - See below for common issues

Gather Information

Have this ready before reporting:

# System information
uname -a
neofetch  # or myfastfetch

# ArxOS version
cat /etc/os-release

# Package versions (if package-related)
pacman -Q | grep package-name

# Error logs
journalctl -xe  # System logs
dmesg | tail -50  # Kernel messages

# Hardware info (if hardware-related)
lspci
lsusb
inxi -Fxz

---

📝 How to Report a Bug

Use the Issue Template

When creating a new issue, use one of our templates:

1. 🐛 Bug Report - For system errors and malfunctions
2. 💡 Feature Request - For new features or enhancements
3. 📚 Documentation - For documentation issues
4. ❓ Question - For general questions (if not answered in docs)

Bug Report Template

## Bug Description
A clear and concise description of what the bug is.

## Steps to Reproduce
1. Go to '...'
2. Click on '....'
3. Run command '....'
4. See error

## Expected Behavior
What you expected to happen.

## Actual Behavior
What actually happened.

## System Information
- **ArxOS Version**: v2026.1 ~ Venus
- **Kernel Version**: (from `uname -r`)
- **Desktop Environment**: KDE Plasma 6
- **CPU**: (from `lscpu`)
- **GPU**: (from `lspci | grep VGA`)
- **RAM**: (from `free -h`)

## Error Messages

Paste error messages or logs here

## Screenshots
If applicable, add screenshots to help explain your problem.

## Additional Context
Any other information that might be helpful.

Feature Request Template

## Feature Description
A clear description of the feature you'd like to see.

## Use Case
Explain why this feature would be useful and how you'd use it.

## Proposed Solution
How you think this could be implemented.

## Alternatives Considered
Any alternative solutions or features you've considered.

## Additional Context
Any other context, mockups, or examples.

---

🏷️ Issue Labels

We use labels to categorize and prioritize issues:

Type Labels

• bug - Something isn't working
• enhancement - New feature or request
• documentation - Documentation improvements
• question - Further information requested
• help-wanted - Community help needed

Priority Labels

• priority: critical - System-breaking bugs
• priority: high - Major issues affecting many users
• priority: medium - Moderate issues
• priority: low - Minor issues or nice-to-haves

Status Labels

• status: investigating - Under investigation
• status: confirmed - Bug confirmed, working on fix
• status: in-progress - Currently being worked on
• status: needs-info - More information needed
• status: wont-fix - Won't be fixed (with explanation)
• status: duplicate - Duplicate of another issue

Component Labels

• component: installer - Calamares installer issues
• component: desktop - KDE Plasma/GUI issues
• component: kernel - Kernel-related issues
• component: packages - Package management issues
• component: hardware - Hardware compatibility
• component: performance - Performance issues
• component: scripts - Custom script issues
• component: network - Network/connectivity issues

---

🔄 Issue Lifecycle

1. Reported → Issue created by user

2. Triaged → Reviewed and labeled by maintainers

3. Confirmed → Bug reproduced or feature approved

4. In Progress → Actively being worked on

5. Fixed/Implemented → Solution committed

6. Closed → Resolved and verified

---

⚡ Quick Fixes (FAQ)

Common Issues & Solutions

"ArxOS won't boot"

# Boot into live USB
# Mount your installation
mount /dev/sdXY /mnt
arch-chroot /mnt

# Reinstall GRUB
grub-install /dev/sdX
grub-mkconfig -o /boot/grub/grub.cfg

"Package conflicts during update"

# Clear package cache
sudo pacman -Scc

# Refresh mirrors
arxos-mirrors

# Try update again
arxos-update

"Orphaned packages"

# Remove orphaned packages
arxos-orphans
# Or manually:
sudo pacman -Rns $(pacman -Qtdq)

"KDE Plasma not loading"

# Reinstall Plasma
sudo pacman -S plasma-meta

# Reset KDE config
mv ~/.config/plasma* ~/.config/plasma-backup/

"CPU Governor not working"

# Check status
cpu-governor status

# Reinstall if needed
cd ~/cpu-governor
sudo ./install.sh

"WiFi not working"

# Check network manager
sudo systemctl status NetworkManager
sudo systemctl restart NetworkManager

# Or use nmcli
nmcli device wifi list
nmcli device wifi connect "SSID" password "password"

---

🤝 Contributing to Fixes

Want to help fix bugs? Here's how:

For Developers

1. Fork the main ArxOS repository
2. Create a branch for your fix

   git checkout -b fix/issue-123

3. Make your changes and test thoroughly
4. Reference the issue in your commit

   git commit -m "Fix: Resolve boot issue (#123)"

5. Submit a pull request to the main repo
6. Link to this issue in your PR description

For Testers

• Test proposed fixes and report results
• Provide additional information when requested
• Verify fixes on different hardware
• Update the issue with your findings

For Documenters

• Improve documentation based on common issues
• Write tutorials for workarounds
• Update FAQ with solutions
• Clarify confusing instructions

---

📊 Priority Guidelines

Critical (Fix Immediately)

• System won't boot
• Data loss or corruption
• Security vulnerabilities
• Complete system failure

High (Fix Soon)

• Major features broken
• Affects most users
• Significant performance degradation
• Hardware compatibility issues

Medium (Fix When Possible)

• Minor features broken
• Affects some users
• Moderate inconvenience
• Cosmetic issues with impact

Low (Nice to Have)

• Minor cosmetic issues
• Edge case bugs
• Enhancement requests
• Documentation improvements

---

🔒 Security Issues

DO NOT report security vulnerabilities as public issues.

For Security Bugs:

1. Email: contact.arxos@proton.me
2. Subject: [SECURITY] Brief description
3. Include:
   • Vulnerability description
   • Steps to reproduce
   • Potential impact
   • Suggested fix (if any)

We'll respond within 48 hours and work with you to resolve the issue before public disclosure.

---

📞 Getting Help

Before Opening an Issue

1. Documentation: ArxOS README
2. Website: thearxos.github.io
3. Scripts & Tools: ArxOS Tools Repository
4. Arch Wiki: wiki.archlinux.org

Contact Methods

• GitHub Issues: For bugs and feature requests (this repo)
• Email: contact.arxos@proton.me (for private matters)
• Website: thearxos.github.io/contact

Response Times

• Critical bugs: Within 24 hours
• High priority: Within 3 days
• Medium/Low: Within 1 week
• Feature requests: Reviewed monthly

---

📈 Issue Statistics

Track our progress:

• Open Issues:
• Closed Issues:
• Average Resolution Time: Updated monthly
• Most Common Issues: See Wiki

---

🎖️ Top Contributors

We recognize and thank our top bug reporters and fixers:

• 🥇 Most Helpful Bug Reports: Listed quarterly
• 🥈 Most Fixes Contributed: Updated monthly
• 🥉 Best Testers: Recognized annually

Want to be featured? Contribute quality bug reports and help test fixes!

---

📜 Issue Etiquette

DO:

• ✅ Be respectful and professional
• ✅ Provide detailed information
• ✅ Follow up on your issues
• ✅ Test proposed solutions
• ✅ Mark issues as resolved when fixed
• ✅ Thank contributors for their help

DON'T:

• ❌ Bump issues unnecessarily
• ❌ Open duplicate issues
• ❌ Use issues for chat/discussion
• ❌ Demand immediate fixes
• ❌ Post "+1" or "me too" comments (use 👍 reaction instead)
• ❌ Go off-topic

---

🔗 Related Links

• ArxOS Website: thearxos.github.io
• Main Repository: github.com/thearxos/thearxos.github.io
• Tools & Scripts: github.com/thearxos/tools-scripts
• CPU Governor: github.com/0xb0rn3/cpu-governor
• Developer Portfolio: 0xb0rn3.github.io

---

📊 Monthly Reports

We publish monthly summaries of:

• Bugs fixed
• Features implemented
• Most common issues
• Upcoming improvements

Check the Releases section for monthly reports.

---

🙏 Thank You

Your bug reports and feedback help make ArxOS better for everyone. Thank you for:

• Taking the time to report issues
• Providing detailed information
• Testing fixes and updates
• Contributing solutions
• Being patient while we work on fixes
• Being part of the ArxOS community

---

Made with 🐛 by the ArxOS Community
© 2026 ArxOS • Created by oxbv1 | 0xb0rn3

---

ArxOS Bug Tracker — Together, we build a better OS 🐛