In this guide I will explain all the steps needed to get OpenBullet 2 up and running on your system.
This can be achieved in several ways.
Running a precompiled build
If you don’t want to mess with docker and don’t want to compile your own build, you can use the latest automatically compiled build available on github.
First of all visit this page and download the
OpenBullet2.zip file (do not select the source code option). Once you downloaded it, unzip it to a folder of your choice.
Now it’s time to install the asp.net core runtime. You can find instructions on how to install it on your system at the link provided.
When you’re done, you can test if it got installed properly by opening a command prompt and typing
dotnet --version, which should output a version number like
5.0 or above.
Navigate to the folder where the file
OpenBullet2.dll is located (the one you just unzipped) and launch it by using the following command:
If you’re on Windows 64 bit, you can double click on
OpenBullet2.exe instead to achieve the same result (on Windows 32 bit you need to use the terminal command above).
You should now be able to navigate to
http://localhost:5000 on your browser in order to see the OpenBullet 2 setup screen.
Install docker from Get Docker | Docker Documentation
Create a folder (e.g. on windows you can create
C:/OB2/UserData) where your settings will be stored, and then run
docker run --name openbullet2 --rm -p 8069:5000 -v C:/OB2/UserData/:/app/UserData/ -it openbullet/openbullet2:latest
and finally navigate to
http://localhost:8069 to access your dockerized OB2 instance!
Let’s break down the docker command:
-p 8069:5000 will map your local port 8069 to the container’s port 5000 where OB2 is listening
-v C:/OB2/UserData/:/app/UserData/ will map the
C:/OB2/UserData directory on your system to the
/app/UserData directory inside the container so that even if you switch container in the future (e.g. to update your OB2 instance) you won’t lose your settings
-it will start an interactive shell that lets you see the output of the OB2 webserver for debugging purposes. You can remove this if you don’t care about it.
Compiling your own build
git clone https://github.com/openbullet/OpenBullet2/
now cd into the folder where
and compile OB2 using
dotnet publish --configuration Release
you can then navigate to the publish folder and start OB2 with the usual command
cd bin/Release/net5.0/publish dotnet ./OpenBullet2.dll