Logbull
Log Bull - simple log collection and view system. Self hosted, zero-config, support of languages (Python, Go, Java, PHP, etc.). Simple alternative to ELK and Loki
Install / Use
/learn @logbull/LogbullREADME
To send logs you have libraries for many languages. Just a Python example:
from logbull import LogBullLogger
# Initialize logger
logger = LogBullLogger(
host="http://LOGBULL_HOST",
project_id="LOGBULL_PROJECT_ID",
api_key="YOUR_API_KEY" # optional, if you need it
)
# Log messages (printed to console AND sent to LogBull)
logger.info("User logged in successfully", fields={
"user_id": "12345",
"username": "john_doe",
"ip": "192.168.1.100"
})
See more examples on <a href="https://logbull.com?language_example=python#how-to-use-in-code" target="_blank">Python</a>, <a href="https://logbull.com?language_example=go#how-to-use-in-code" target="_blank">Go</a>, <a href="https://logbull.com?language_example=java#how-to-use-in-code" target="_blank">Java</a>, <a href="https://logbull.com?language_example=javascript#how-to-use-in-code" target="_blank">JavaScript</a>, <a href="https://logbull.com?language_example=php#how-to-use-in-code" target="_blank">PHP</a>, <a href="https://logbull.com?language_example=csharp#how-to-use-in-code" target="_blank">C#</a>, <a href="https://logbull.com?language_example=ruby#how-to-use-in-code" target="_blank">Ruby</a>, <a href="https://logbull.com?language_example=rust#how-to-use-in-code" target="_blank">Rust</a> and <a href="https://logbull.com?language_example=curl#how-to-use-in-code" target="_blank">cURL</a> here - https://logbull.com/#how-to-use-in-code
✨ Features
🐳 Easy Deployment
Log Bull is an Apache 2.0 licensed, self-hosted log collection system designed for developers and small teams. Unlike ELK (Elasticsearch, Logstash, Kibana) or Loki which require complex configurations, Log Bull works out of the box with zero configuration and runs as a single lightweight Docker container.
- Docker-based: Launch in Docker with one command - the entire process takes less than 2 minutes
- Zero configuration: Works out of the box without any setup
- Self-hosted: All your data stays on your infrastructure - no data ever leaves your servers
- Open source: Apache 2.0 licensed - you or your security team can audit every line of code
📝 Multi-Language Log Collection
The system supports virtually any language that can send HTTP requests. You don't need to change your existing logging code — just add Log Bull as an additional handler to your current logger.
- <a href="https://logbull.com?language_example=python#how-to-use-in-code" target="_blank">Python</a>: LogBullLogger, logging (standard library), Loguru, Structlog
- <a href="https://logbull.com?language_example=go#how-to-use-in-code" target="_blank">Go</a>: LogBull native, slog, Zap, Logrus
- <a href="https://logbull.com?language_example=java#how-to-use-in-code" target="_blank">Java</a>: Spring Boot, Logback + SLF4J, LogBull native
- <a href="https://logbull.com?language_example=javascript#how-to-use-in-code" target="_blank">JavaScript/TypeScript</a>: LogBull native, Winston, Pino
- <a href="https://logbull.com?language_example=csharp#how-to-use-in-code" target="_blank">C#/.NET</a>: LogBull native, Microsoft.Extensions.Logging, Serilog
- <a href="https://logbull.com?language_example=php#how-to-use-in-code" target="_blank">PHP</a>: LogBull native, Monolog, PSR-3, Laravel
- <a href="https://logbull.com?language_example=ruby#how-to-use-in-code" target="_blank">Ruby</a>
- <a href="https://logbull.com?language_example=rust#how-to-use-in-code" target="_blank">Rust</a>
- <a href="https://logbull.com?language_example=curl#how-to-use-in-code" target="_blank">cURL</a>: Direct HTTP API access
- And many more: Supports any application that can send HTTP requests
🎯 Project Management
Install Log Bull once and use it for all your applications. Each project gets its own isolated log space with separate project IDs and API keys. You can organize logs by microservices, environments (dev, staging, production), or any other structure that fits your workflow.
- Multiple projects: Organize logs by different applications or services
- Project isolation: Keep logs separated with their own API keys
- Easy switching: Quick project selection in the dashboard
- Flexible organization: Structure projects however fits your team's needs
👥 Multi-User Support
Add team members (developers, DevOps, project managers) and control their access to specific projects. The system includes built-in multi-user support with granular access management.
- Team collaboration: Add multiple users to your Log Bull instance
- Access management: Control which projects each user can access
- User roles: Manage permissions for different team members
- Secure authentication: Built-in user authentication system
📊 Audit Logging
Each user action is tracked in audit logs, showing who changed what and when. Complete transparency for your logging infrastructure.
- Complete audit trail: See who changed settings and when
- User activity tracking: Monitor all user actions in the system
- Change history: Track modifications to projects and configurations
- Accountability: Know exactly what happened and who did it
🔍 Powerful Log Querying
Search logs by text, filter by fields, and query within specific time ranges. All without complex query languages or configurations.
- Advanced search: Find logs quickly with powerful search capabilities
- Real-time viewing: Stream logs as they arrive in your applications
- Flexible filtering: Filter logs by various criteria and custom fields
- Time-based queries: Search logs within specific time ranges
- Simple interface: No complex query language needed
🔐 API Keys & Security
Control the amount of logs, allowed domains, and instances. You decide who sends logs to your system with configurable limits and restrictions.
- API key management: Separate keys for each project
- Domain restrictions: Control which domains can send logs
- Rate limiting: Set limits on log volume and frequency
- Instance control: Restrict the number of instances that can connect
💻 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
Note on Storage: Log Bull is designed for developers and small teams, not for enterprises with terabytes of logs. All logs are stored locally on your server in the mounted volume (./logbull-data directory). Storage usage depends on your log volume, but the system includes configurable retention policies and limits to help manage disk space effectively while keeping your most important logs accessible.
📦 Installation
Log Bull can be installed in three ways: automated script (recommended), simple Docker run, or Docker Compose setup. The fastest method is the one-line automated installation script which automatically installs Docker (if needed), pulls the image, sets up the container, and configures automatic startup on system reboot. The entire process takes less than 2 minutes.
Option 1: Automated Installation Script (Recommended, Linux only)
The installation script will automatically:
- ✅ Install Docker with Docker Compose (if not already installed)
- ✅ Pull the Log Bull image and set up the container
- ✅ Configure automatic startup on system reboot
- ✅ Get you up and running in under 2 minutes
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 with a single command. All logs are stored locally on your server in the mounted volume.
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 and expose it on port 4005
- ✅ Store all data in
./logbull-datadirectory on your server - ✅ Automatically restart on system reboot
- ✅ Include health checks to ensure the system is running properly
Option 3: Docker Compose Setup
Create a docker-compose.yml file with the following configuration:
services:
logbull:
container_name: logbull
image: l
Related Skills
openhue
347.2kControl Philips Hue lights and scenes via the OpenHue CLI.
sag
347.2kElevenLabs text-to-speech with mac-style say UX.
weather
347.2kGet current weather and forecasts via wttr.in or Open-Meteo
Better-Prompt
Publishable Prompt Engineering skill package that compiles a user request into a ready-to-use high-quality Prompt, with support for diagnosis, module injection, debugging, and evaluation.
