Skip to main content

Introduction to Fermentrack

Fermentrack is a web application for monitoring and controlling fermentation processes. It works with temperature controllers such as those based on the BrewPi-ESP project and gravity sensors like Tilt hydrometers.

Key Features​

  • Temperature Control: Precise fermentation temperature control with BrewPi-ESP devices
  • Gravity Monitoring: Track fermentation progress with gravity sensors (Tilt, iSpindel, TiltBridge)
  • Cloud Backup: Securely backup your fermentation data to cloud storage providers
  • Multi-tenant Support: Support for multiple brewhouses in a single installation
  • Modern Architecture: Django backend with Vue.js frontend

Architecture Overview​

Fermentrack 2 uses a modern web architecture:

  • Backend: Django with Django REST Framework
  • Frontend: Vue.js 3 with Vite
  • Database: PostgreSQL
  • Task Queue: Celery with Redis
  • Real-time Data: Redis for caching sensor data

Getting Started​

For Users​

If you're setting up Fermentrack for your brewery, start with:

  1. BrewPi-ESP Device Setup
  2. Dropbox Cloud Backup

For Developers​

If you're contributing to or extending Fermentrack:

  1. Implementing Gravity Sensors - Add support for new gravity sensor types
  2. Developing Cloud Storage Providers - Add new cloud backup options
  3. Frontend Authentication Migration - Understanding the authentication system

Running Locally​

# Install dependencies with uv
uv sync --all-extras

# Run the development server
uv run python manage.py runserver

# Run tests
uv run pytest