POMjs

Self-Hosted

Open-source self-hosted Pomodoro timer for distraction-free focus

Overview

POMjs is a minimal, self-hosted Pomodoro timer built with JavaScript, focusing on core functionality without unnecessary bloat. It allows users to set custom work and break intervals, track session history via local browser storage, and enjoy a clean, distraction-free interface. Deployment is hassle-free—host as static files on any web server (e.g., Apache, Nginx) or use the Docker image for quick setup. No backend or database is required, making it lightweight and easy to maintain. Ideal for anyone seeking a private, ad-free alternative to cloud-based Pomodoro tools.

Self-Hosting Resources

Find Official Image on Docker Hub View Source & Docs

Below is a reference structure for docker-compose.yml. ⚠️ Do NOT run blindly. Replace placeholders with official values.

docker-compose.template.yml TEMPLATE


version: '3'
services:
  pomjs:
    image: <OFFICIAL_IMAGE_NAME>:latest
    container_name: pomjs
    ports:
      - "8080:<APP_INTERNAL_PORT>"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

Key Features

Customizable work/break durations
Local browser storage for session tracking
No backend or database dependencies
Static hosting & Docker deployment options

Frequently Asked Questions

? Is POMjs hard to install?

No—POMjs can be deployed as static files on any web server (like Nginx or Apache) or via its Docker image. It has no backend or database requirements, so setup takes minutes with no technical expertise needed beyond basic hosting knowledge.

? Is it a good alternative to Forest?

Yes—if you prioritize privacy and self-hosting over Forest’s gamification features. POMjs offers core Pomodoro functionality (work/break cycles) without relying on cloud services, ensuring your session data stays local to your device.

? Is it completely free?

Absolutely—POMjs is open-source under the MIT License, meaning it’s free to use, modify, and self-host with no subscription fees or hidden costs.

Top Alternatives

Forest (proprietary) Search Google

Todoist Pomodoro (proprietary) Search Google

Focus@Will (proprietary) Search Google

Tool Info

Pricing Free/Open Source

Category Miscellaneous

Platform Self-Hosted

Pros

⊕ Privacy-focused (no external data tracking)
⊕ Minimalist, distraction-free UI
⊕ Easy to deploy (static files or Docker)
⊕ Open-source (MIT License for modification)

Cons

⊖ Limited advanced features (no team sync or gamification)
⊖ Basic UI (lacks visual customization)
⊖ Web-only (no native mobile app)
⊖ Requires self-hosting setup (for full control)