Favicon of Octobox

Octobox

Manage your GitHub notifications effectively. Archive threads when done, search and filter by status or type, and see live updates for issues, PRs, and CI.

If you're overwhelmed by hundreds of GitHub notifications and worry about losing track of important issues, this tool provides a dedicated inbox to untangle them. It introduces an "archived" state, allowing you to mark notifications as "done" and clear your view. If any activity occurs on an archived thread, issue, or pull request, it automatically returns to your inbox so you never miss an update.

Stay focused with powerful search and filtering capabilities. You can sort notifications by:

  • Repository or organization
  • Notification type (issue, PR) and action
  • CI status and reason
  • Author and assignee

By installing the GitHub app, you can enhance your notifications with live information, including issue/PR status, CI status, and labels, keeping everything up-to-date in one place. The tool is free for open source projects, with paid plans available for private repositories. You can also self-host the application for complete control.

Directory Structure

octobox
db-data
redis-data
.env
docker-compose.yml

docker-compose.yml

services:
  db:
    image: postgres:13-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: octobox
      POSTGRES_DB: octobox
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - ./db-data:/var/lib/postgresql/data

  redis:
    image: redis:6-alpine
    restart: unless-stopped
    volumes:
      - ./redis-data:/data

  web:
    image: octobox/octobox:latest
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgres://octobox:${POSTGRES_PASSWORD}@db:5432/octobox
      REDIS_URL: redis://redis:6379/0
      GITHUB_CLIENT_ID: ${GITHUB_CLIENT_ID}
      GITHUB_CLIENT_SECRET: ${GITHUB_CLIENT_SECRET}
      SECRET_KEY_BASE: ${SECRET_KEY_BASE}
    depends_on:
      - db
      - redis

  worker:
    image: octobox/octobox:latest
    restart: unless-stopped
    command: bundle exec sidekiq
    environment:
      DATABASE_URL: postgres://octobox:${POSTGRES_PASSWORD}@db:5432/octobox
      REDIS_URL: redis://redis:6379/0
      GITHUB_CLIENT_ID: ${GITHUB_CLIENT_ID}
      GITHUB_CLIENT_SECRET: ${GITHUB_CLIENT_SECRET}
      SECRET_KEY_BASE: ${SECRET_KEY_BASE}
    depends_on:
      - db
      - redis

.env

POSTGRES_PASSWORD=your_secure_postgres_password
GITHUB_CLIENT_ID=your_github_oauth_client_id
GITHUB_CLIENT_SECRET=your_github_oauth_client_secret
SECRET_KEY_BASE=your_super_secret_key_base_string
Categories:

Share:

Ad
Favicon

 

  
 

Similar to Octobox

Favicon

 

  
  
Favicon

 

  
  
Favicon