A self-hosted Developer Operations Platform for engineering teams.
oblok provides a unified workspace for monitoring services, tracking deployments, inspecting queues, managing incidents, and operating backend applications — without depending on third-party SaaS.
Engineering teams typically rely on a fragmented set of tools to operate their applications: one for uptime monitoring, another for log aggregation, another for deployment tracking, and yet another for queue inspection. Each tool requires its own account, configuration, and mental model.
oblok consolidates these operational concerns into a single, self-hosted platform. One deployment. One interface. Full ownership of your data.
See docs/vision.md for the full project philosophy.
Want to connect your own application? See docs/connect-your-project.md.
- Authentication — Registration, login, password reset, session management.
- Project Management — Organize services by project with metadata and search.
- Dashboard — Per-project operational overview with summary metrics and activity feed.
- Service Monitoring — HTTP health checks with configurable intervals, uptime tracking, and status history.
- Log Aggregation — Ingestion API + log stream view with levels and search.
- Queue Monitoring — Horizon/Redis-backed queue dashboard.
- Deployment Tracking — Public webhook receiver + deployment timeline.
- Incidents — Manual logging, resolution, and service-failure triggers.
- Alerting — Alert rules, notification channels (mail/webhook/Slack), delivery history.
- Webhook Inspector — Capture, inspect, and replay incoming webhooks.
- Scheduler Monitoring — Cron task tracking and missed-run detection.
- Custom Metrics — Push API, Prometheus-compatible scrape targets, and dashboards.
- API Key Management — Per-project Bearer keys for machine-to-machine access.
- GitHub Integration — Repository context (commits, pull requests).
- Messaging Integrations — Slack via a driver framework (Discord/Telegram ready).
- oblok-agent — Standalone log shipper and request monitor for any stack.
See docs/roadmap.md for the full development timeline.
Screenshots will be added once the MVP interface is complete.
| Component | Technology |
|---|---|
| Backend | Laravel 13 / PHP 8.4 |
| Database | PostgreSQL |
| Cache / Queue | Redis |
| Realtime | Laravel Reverb |
| Frontend | Blade, Alpine.js, Tailwind CSS |
| Charts | ApexCharts |
| Testing | Pest |
| Infrastructure | Docker Compose, Nginx |
| CI | GitHub Actions |
See docs/tech-stack.md for detailed rationale and tradeoffs.
- Docker and Docker Compose
- Git
# Clone the repository
git clone https://github.com/fazleyrabby/oblok.git
cd oblok
# Install PHP & JS dependencies
composer install
npm install && npm run build
# Copy environment configuration
cp .env.example .env
php artisan key:generate
# Start Docker containers (optional)
docker compose up -d
# Run database migrations
php artisan migrate
# Run Pest tests
./vendor/bin/pest| Document | Description |
|---|---|
| Vision | Why oblok exists — mission, philosophy, principles |
| Specification | Product requirements and MVP scope |
| Architecture | System design, Clean Architecture, module boundaries |
| UX Design | Navigation, layouts, user flows, interaction patterns |
| Design System | Visual language — colors, typography, components |
| Tech Stack | Technology choices with rationale and tradeoffs |
| Development | Engineering handbook — standards, Git workflow, testing |
| Roadmap | Development timeline from v0.1 to v1.0+ |
| AI Agents | Guidelines for AI coding agents |
| Version | Theme | Status |
|---|---|---|
| v0.1 | Foundation — Auth, Projects, Dashboard, Monitoring | ✅ Delivered |
| v0.2 | Observability — Logs, Queues, Notifications | ✅ Delivered |
| v0.3 | Control Plane — Deployments, Metrics, API Keys | ✅ Delivered |
| v0.4 | Integrations — Webhooks, Scheduler, Third-Party | ✅ Delivered |
| v0.5 | Intelligence — AI Assistant, Incident Suggestions | 🔄 In Progress |
| v1.0 | Public Release — Stability, Docs, Hardening | ⚪ Planned |
See docs/roadmap.md for detailed milestone contents.
Contributions are welcome. Before contributing:
- Read docs/vision.md to understand the project direction.
- Read docs/development.md for coding standards and workflow.
- Read AGENTS.md if using AI coding assistance.
- Fork the repository.
- Create a feature branch from
main. - Make focused, well-tested changes.
- Submit a pull request following the PR checklist.
oblok is open-source software. See LICENSE for details.