Files
amd-bc250-docs/README.md
Naster 8961369398 linux: Alpine Setup guide (#20)
New Alpine guide covering kernel selection, AMDGPU/Vulkan stack,
extlinux/GRUB kargs, and a manual SMU governor build with an
OpenRC service + D-Bus policy. Adds nav entry, README/index
mentions, and an Alpine row in the distribution comparison.
Note: the "D-Bus AccessDenied Error" troubleshooting entry is
missing its solution paragraph will follow up in a small fix
commit after merge.

Closes #20.
2026-06-01 06:59:01 -07:00

75 lines
3.0 KiB
Markdown

# AMD BC250 Documentation
[![Documentation](https://img.shields.io/badge/docs-live-blue.svg)](https://elektricM.github.io/amd-bc250-docs/)
[![License: CC BY-SA 4.0](https://img.shields.io/badge/License-CC%20BY--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-sa/4.0/)
[![Code License: MIT](https://img.shields.io/badge/Code%20License-MIT-yellow.svg)](LICENSE)
[![Contributions Welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](CONTRIBUTING.md)
[![Discord](https://img.shields.io/discord/1320414880956571719?color=7289da&label=Discord&logo=discord)](https://discord.gg/8eZfFWhczz)
**Comprehensive, community-driven documentation for the AMD BC250 board.**
📖 **Read the docs:** [https://elektricM.github.io/amd-bc250-docs/](https://elektricM.github.io/amd-bc250-docs/)
✏️ **Contribute:** Found a solution? Add it to the docs so everyone can find it! See [CONTRIBUTING.md](CONTRIBUTING.md)
[![Preview](https://elektricM.github.io/amd-bc250-docs/assets/preview.png)](https://elektricM.github.io/amd-bc250-docs/)
## What's Included
- **Linux setup guides** for 7+ distributions (Fedora, Bazzite, CachyOS, Arch, Debian, Alpine, etc.)
- **BIOS flashing** and configuration (including GPU frequency patch)
- **Hardware specs** - power requirements, cooling, display compatibility
- **Troubleshooting** - boot issues, performance problems, stability fixes
- **Gaming compatibility** - tested games, settings, FPS data
- **Driver setup** - RADV configuration, environment variables
- **Community cases catalogue** - 145 case/enclosure designs, searchable and filterable
- **System configuration** - GPU governor (cyan-skillfish-governor-smu recommended), sensors, power management
## Building Locally
```bash
# Install dependencies
pip install mkdocs-material
# Serve locally with live reload
mkdocs serve
# Build static site
mkdocs build
```
The site will be available at http://127.0.0.1:8000/
## Content Sources
Built from:
- BC250 Discord community (9,716 technical messages from 3,500+ members)
- [BC250 GitHub repository](https://github.com/mothenjoyer69/bc250-documentation)
- Last Updated: March 2026
## Contributing
**Please contribute your knowledge!** Instead of posting solutions in Discord where they get lost, add them to the documentation:
- **Easy way:** Click "Edit on GitHub" on any page and submit changes
- **Report issues:** Found wrong info? [Open an issue](https://github.com/elektricM/amd-bc250-docs/issues)
- **Full guide:** See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions
**What we need:**
- ✅ Tested hardware configurations
- ✅ Game compatibility reports
- ✅ Troubleshooting solutions you've found
- ✅ Distribution-specific setup steps
- ✅ Fixes for outdated information
**Join Discord:** [https://discord.gg/8eZfFWhczz](https://discord.gg/8eZfFWhczz) - but please document your solutions here!
## License
- Documentation: CC BY-SA 4.0
- Code: MIT
---
Built with [MkDocs](https://www.mkdocs.org/) and [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/)