Skip to content

alanquillin/brewhouse-manager

Repository files navigation

Brewhouse Manager Logo

The Brewhouse Manager is an open source application designed for the home/micro brewer to help track what they have brewed and what they have on tap. In order to make tracking your beer better, the Brewhouse Manager optionally integrates with 3rd party brew systems and tap monitors to pull in your batch details and track the beer levels in your kegs.

Supported Third Party Integrations

Brewfather      Plaato      Kegtron

Brew tracking applications

  • brewfather: The brewfather integration allows you to associate a batch with a beer to auto import details. These details will refresh automatically until the batch is marked as completed.

Tap Monitoring Sensors

Plaato Keg

These devices have been discontinued and are no longer supported by the manufacturer. However, like us, we know there are many die-hard fans out there taking theirs to the grave. Since their services have been discontinued, open source options have become available to support them.

Brewhouse Manager now supports two integration methods for Plaato Keg devices:

  1. Native Integration (Recommended): Direct TCP connection with Plaato Keg devices

    • No external services required
    • Full device configuration capabilities (mode, units, calibration)
    • Real-time sensor data streaming
    • Device management UI at /manage/plaato_kegs
    • Configuration required: See Tap Monitor configuration
  2. Open-Plaato-Keg Service: HTTP-based integration

    • Requires separate open-plaato-keg service (version 0.0.11+)
    • Read-only sensor data access
    • Useful if you already have open-plaato-keg running

Other Tap Monitoring Sensors

Quick Installation

The quickest way to start up the application is to run with Docker. This requires a PostgreSQL database. If you want to run the application with SSL or with along side a dedicated PostgreSQL database in docker, see the detailed installation guide.

  1. Create a file named docker.env add add the following content, replacing the placeholder values with your DB credentials and inital

    DB_USERNAME=<USERNAME>
    DB_PASSWORD=<PASSWORD>
    DB_NAME=<NAME OF DATABASE>
    DB_HOST=<DATABASE HOSTNAME>
    AUTH_INITIAL_USER_EMAIL=<YOUR EMAIL>
    AUTH_INITIAL_USER_PASSWORD=<>
  2. Then run the following from the command to start the application. This runs with the default configurations. To enable more advanced configurations, see the detailed installation guide or see the configuration options update your docker.env.

    docker run --env-file ./docker.env alanquillin/brewhouse-manager:latest
  3. Once the application is up and running, go to https://localhost:5000/manage to start managing your application. To log in, use credentials you added in the environment variables. If you did not add credentials for the initial user you will need to use the default credentials found in the default config.

  4. Once you have it all configured, you can monitor your taps at http://localhost:5000

About

Brewhouse Manager and Tap Monitor

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors