Installing Beaker

MacOS: Download the installer
Windows: Download the installer
Linux: Download the AppImage

Note 1: Windows will prompt you with a security concern before install. It is safe to continue! Beaker is downloaded via secure connection from (We’re still working on signing the release, which will solve that problem.)

Note 2: Linux users don’t have an auto-updater yet. You’ll need to download new versions manually for now. Sorry!

You can report issues here.

Building from source

Requires node 6 or higher. On windows, you may need to use npm version 4, due to a bug in npm 5.

In Linux (and in some cases OSX) you need libtool, m4, and automake:

bash (linux)
sudo apt-get install libtool m4 make g++  # debian/ubuntu
sudo dnf install libtool m4 make gcc-c++  # fedora

In Windows, you’ll need to install Python 2.7, Visual Studio 2015 or 2017, and Git. (You might try windows-build-tools.) Then run:

powershell (windows)
npm config set python c:/python27
npm config set msvs_version 2015
npm install -g node-gyp
npm install -g gulp

To build:

bash (linux) or powershell (windows)
git clone
cd beaker
npm install
npm run rebuild #see
npm start

If you pull latest from the repo and get weird module errors, do:

bash (linux) or powershell (windows)
npm run burnthemall

This invokes the mad king, who will torch your node_modules/, and do the full install/rebuild process for you. npm start should work afterwards.

If you’re doing development, npm run watch to have assets build automatically.