← TallyHub Pro

Installation Guide

Choose your platform and get TallyHub running in minutes

🍎
macOS
🪟
Windows
🐧
Linux/Server
🐳
Docker/Pi

macOS Installation

1. Download TallyHub

Apple Silicon (M1/M2/M3)
v1.2.0
Intel Macs
v1.2.0

2. Install the Application

  1. 1. Open the downloaded .dmg file
  2. 2. Drag TallyHub to your Applications folder
  3. 3. Launch TallyHub from Applications

⚠️ Security Warning Fix

If you see "TallyHub is damaged and can't be opened", this is a macOS Gatekeeper issue. Run this command in Terminal:

xattr -cr /Applications/TallyHub.app

For more details, see MACOS_INSTALLATION.md

3. First Launch

  • • TallyHub will open at http://localhost:3000
  • • Admin panel: http://localhost:3000/admin
  • • Tally view: http://localhost:3000/tally
  • • Firmware flasher: http://localhost:3000/flash.html

Windows Installation

1. Download TallyHub

Download for Windows (v1.2.0)

2. Install and Run

  1. 1. Run the downloaded installer
  2. 2. Follow the installation wizard
  3. 3. Launch TallyHub from the Start Menu or Desktop shortcut
  4. 4. Access the web interface at http://localhost:3000

💡 Windows Firewall

You may need to allow TallyHub through Windows Firewall for device discovery to work properly.

Linux/Server Installation

Prerequisites

  • • Node.js 20.9.0 or higher
  • • npm or yarn
  • • Git

Installation Steps

1. Clone the repository:

git clone https://github.com/tallyhubpro/Tallyhub.git
cd Tallyhub

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Start the server:

NODE_ENV=production npm start

Or use the CLI launcher:

NODE_ENV=production npx tallyhub

Development Mode

For development with hot reload:

npm run dev

Docker & Raspberry Pi Installation

🚀 Quick Install (Recommended)

Install TallyHub on Raspberry Pi or Linux with a single command:

curl -fsSL https://raw.githubusercontent.com/tallyhubpro/Tallyhub/main/install.sh | sudo bash

This will automatically:

  • ✅ Install Docker (if needed)
  • ✅ Pull latest TallyHub image
  • ✅ Create directories and volumes
  • ✅ Start TallyHub with auto-restart

Access Points

After installation, access TallyHub at:

  • • Main interface: http://<pi-ip>:3000/
  • • Admin panel: http://<pi-ip>:3000/admin
  • • Tally display: http://<pi-ip>:3000/tally
  • • Firmware flasher: http://<pi-ip>:3000/flash.html

Manual Docker Installation

For more control over the installation:

View Docker Deployment Guide

Updating TallyHub

To update to the latest version, simply re-run the install command:

curl -fsSL https://raw.githubusercontent.com/tallyhubpro/Tallyhub/main/install.sh | sudo bash

Next Steps

⚡

Flash Firmware

Set up your ESP32 or M5Stick devices

🚀

Getting Started

Configure your first tally light

🍓

Raspberry Pi Setup

Detailed Raspberry Pi configuration

📚

Documentation

Full feature documentation

Common Issues

⚠️
[macOS] App won't open (damaged)
Solution: Run: xattr -cr /Applications/TallyHub.app
⚠️
[Windows] Devices not discovered
Solution: Allow TallyHub through Windows Firewall
⚠️
[Linux] Port 3000 already in use
Solution: Kill the process or set PORT environment variable
⚠️
[Docker] Can't access web interface
Solution: Ensure port 3000 is mapped and firewall allows access