Troubleshooting

The following pages provide suggestions for common errors that may occur while setting up or using devices running ZMK. If the information provided is insufficient to resolve an issue, feel free to seek out additional help from the ZMK Discord.

📄️ Building Issues

Troubleshooting issues when compiling ZMK firmware.

📄️ Flashing Issues

Troubleshooting issues when flashing ZMK firmware to devices.

📄️ Connection Issues

Troubleshooting wireless connection issues of ZMK devices.

📄️ Hardware Issues

Troubleshooting common hardware issues.