Run a copy of Keyboard Firmware Builder locally

User avatar
swampangel

19 Aug 2019, 17:52

The other day I was getting an error trying to download .hex files from https://kbfirmware.com (it's fine now).

I'd been meaning to set up a copy on my computer, because I want to try some changes to the default wiring method.

The original source https://github.com/ruiqimao/qmkbuilder is easy enough for a developer to use, but the setup still involves a few steps.

So I created a Dockerfile and a compose file at https://github.com/bitswamp/qmkbuilder-docker to automate it. Now you can run your own copy like:
  • Install Docker
  • Download or clone qmkbuilder-docker
  • Start it up with

    Code: Select all

    docker-compose up
It creates 2 docker containers, downloads all the dependencies for QMK and qmkbuilder, and serves it up as a website on the local network.

You don't need node.js or any of the build tools on the host computer, you only need Docker. Tested on Windows and Mac, ought to work the same on Linux.

User avatar
snacksthecat
✶✶✶✶

20 Aug 2019, 00:55

Thank you for putting that together. I'm just getting set up on a new PC and I think this might be one of the first things I do.

Post Reply

Return to “Workshop”