Troubleshooting

Find solutions to common issues, read the FAQ, or reach out to the community for help.

Common Issues & Solutions

WiFi Issues

Graphics / Display

Audio Issues

Trackpad Issues

Boot Issues

T2 Chip Issues

Gaming Issues

Security Issues

Frequently Asked Questions

Get Help

GitHub Issues

Search existing issues or open a new one with your Mac model, kernel version, and logs.

Contact Support

Send a message and we'll assist you

Troubleshooting

Common Issues & Solutions

WiFi Issues

WiFi adapter not detected

WiFi connects but no internet

WiFi drops after suspend

Graphics / Display

Screen tearing

Black screen after boot

Wrong resolution on Retina display

Audio Issues

No sound output

Headphone jack not working

Trackpad Issues

Trackpad not responding

No tap-to-click

Boot Issues

GRUB menu not showing

Mac won't boot from USB

T2 Chip Issues

Keyboard/trackpad not working on T2 Mac

No audio on T2 Mac

T2 Mac won't boot Linux

Gaming Issues

Steam won't launch

Games crash with Proton

Poor gaming performance

Security Issues

Locked out by firewall

Fail2ban blocked my IP

Frequently Asked Questions

Will this erase macOS from my Mac?

Is this a custom Linux distro?

Does my Mac model work?

How much RAM does it use?

Can I play games?

Does Netflix/Spotify/YouTube work?

Can I roll back an update?

The installer failed midway. Can I re-run it?

What security measures are applied by default?

Get Help

GitHub Issues

Contact Support