Installation

You have three ways to install Log Bull: automated script (recommended), simple Docker run, or Docker Compose setup.

System Requirements

Log Bull requires the following minimum system resources to run properly:

CPU: At least 2 CPU cores
RAM: Minimum 4 GB RAM
Storage: 20 GB available disk space (more recommended for log retention)
Docker: Docker Engine 20.10+ and Docker Compose v2.0+
Network: Internet connection for initial setup and updates

Option 1: Automated installation script (Recommended, Linux only)

The installation script will:

✅ Install Docker with Docker Compose (if not already installed)
✅ Set up Log Bull
✅ Configure automatic startup on system reboot


sudo apt-get install -y curl && \
sudo curl -sSL https://raw.githubusercontent.com/logbull/logbull/main/install-logbull.sh \
| sudo bash

Option 2: Simple Docker run

The easiest way to run Log Bull:


docker run -d \
  --name logbull \
  -p 4005:4005 \
  -v ./logbull-data:/logbull-data \
  --restart unless-stopped \
  --health-cmd="curl -f http://localhost:4005/api/v1/system/health || exit 1" \
  --health-interval=5s \
  --health-retries=30 \
  logbull/logbull:latest

This single command will:

✅ Start Log Bull
✅ Store all data in ./logbull-data directory
✅ Automatically restart on system reboot

Option 3: Docker Compose setup

Create a docker-compose.yml file with the following configuration:


services:
  logbull:
    container_name: logbull
    image: logbull/logbull:latest
    ports:
      - '4005:4005'
    volumes:
      - ./logbull-data:/logbull-data
    restart: unless-stopped
    healthcheck:
      test: ['CMD', 'curl', '-f', 'http://localhost:4005/api/v1/system/health']
      interval: 5s
      timeout: 5s
      retries: 30

Then run:


docker compose up -d

Keep in mind that start up can take up to ~2 minutes.

Getting started

After installation:

Launch and access Log Bull: Start Log Bull and navigate to http://localhost:4005
Create your first project: Click “New Project” and copy the generated project ID
Integrate with your application: Connect Log Bull to your existing logger in your codebase (Python, Go, Node.js, etc.)
Start viewing logs: Watch your logs stream in real-time in the Log Bull dashboard!
Manage your setup: Add team members, adjust limits, and configure settings if needed

How to update Log Bull?

To update Log Bull, you need to stop it, clean up Docker cache and restart the container.

Go to the directory where Log Bull is installed (usually /opt/logbull)
Stop the container: docker compose stop
Clean up Docker cache: docker system prune -a
Restart the container: docker compose up -d

It will get the latest version of Log Bull from the Docker Hub (if you have not fixed the version in the docker-compose.yml file).