l1apps/taskbox repository overview

⁠TaskBox - Your Personal Task Manager

Version: 3.11.5

⁠Overview

TaskBox is a standalone, feature-rich task management application designed for individuals and teams. It supports nested lists (sublists), multi-user collaboration, list sharing with granular permissions (View, Modify, Full), admin controls, and extensive task organization features like parent/child relationships and pinning, all in a secure, self-hosted Docker container.

GitHub repository: https://github.com/l1apps/taskbox⁠
Website & Info: https://l1apps.com/taskbox⁠

⁠Installation

⁠1. Docker Compose (Recommended)

1. Create a directory for TaskBox:

mkdir taskbox
cd taskbox

1. Create the docker-compose.yml file:

version: '3.8'

services:
  taskbox:
    image: l1apps/taskbox:latest
    container_name: taskbox
    ports:
      - "6500:3000"
    volumes:
      - ./data:/app/data
    restart: unless-stopped
    environment:
      - NODE_ENV=production
      - PORT=3000
      - JWT_SECRET=your-super-secret-key-that-should-be-in-an-env-file
      - SESSION_TIMEOUT=7d

1. Start the container:

docker-compose up -d

1. Access TaskBox: Open your web browser and navigate to http://<your-server-ip>:6500.

⁠2. Docker Run

docker run -d \
  --name taskbox \
  -p 6500:3000 \
  -v ./data:/app/data \
  -e JWT_SECRET=mysecurekey \
  --restart unless-stopped \
  l1apps/taskbox:latest

⁠Features

• Task Relationships: Link tasks as Parent/Child to create sub-tasks. Parent tasks cannot be completed until all children are done.
• Remember Last List: Automatically reloads the last list you were viewing.
• Global View Persistence: By default, all lists and Global Views remember your sort/filter settings. This can be toggled globally in User Settings or individually per list via the toolbar.
• Custom Task Ordering: Manual Up/Down sorting toggled per list.
• Sidebar Controls: Tri-state toggle for Expand All, Collapse All, and Accordion Mode (auto-close other lists).
• Focused List: Keep track of your most important tasks using the new permanent "Focused" list.
• Global Views: View tasks across all lists via the "File Cabinet". Now includes "All Due Tasks" view.
• Global Search: Instantly find tasks across all your lists using the search bar in the header.
• Printing: Clean, ink-friendly print view. Supports printing Global Views and Focused lists properly across multiple pages.
• Duplicate Prevention: Strict checks during paste/import to prevent creating duplicate tasks.
• Clipboard Management: Copy active lists to clipboard (All Data or Descriptions Only) or paste tasks.
• Sidebar Toolbar: Centralized control for list actions (Rename, Share, Move, Merge, Delete).
• Nested Lists: Hierarchical structure (Top Level -> Master List -> Sublist -> Nested Sublist). Max nesting depth is 3 levels.
• Merge Lists: Consolidate lists by merging them together.
• Multi-User Support: Secure user registration and login system.
• Shared Permissions: Share lists with specific access levels: View Only, Modify, or Full Access.
• Ownership Transfer: Transfer full ownership of lists to other users. Admins can force transfer.
• Admin Panel: User management, security logs (with CSV export), and database maintenance.
• Database Backup/Restore: Download full backups or restore DB via file upload (Admin only).
• Import/Export: Support for CSV and Text files. (Import disabled in Global Views).
• Statistics Page: View completion rates and overdue tasks.
• Custom Themes: Light, Dark, and High-Contrast Orange/Black.

⁠Troubleshooting & Diagnostics

Enable Debug Mode to reveal internal object names and component IDs on tooltips for diagnostics:

• http://<your-ip>:6500/?debug=on
• http://<your-ip>:6500/?tooltips=on
• http://<your-ip>:6500/debug

Hovering over interactive elements will show internal debug labels.

⁠Recovering Lost Admin Password

docker exec -it taskbox node reset_admin.js <admin_username> <new_password>

⁠Version History

See CHANGELOG.md⁠ for full details.

• v3.11.5: Admin Log Export, Transfer Lists, Fix Created Date, User Limit 10
• v3.11.4: Fixed Admin registration permission issue
• v3.11.3: Added "Reset Task Relationships" repair tool to Admin panel
• v3.11.2: Refined Task Relationship UI/Sorting
• v3.11.1: Refined Parent/Child task logic, tooltips, and family context in Global Views
• v3.11.0: Introduced Sub-task Support and replaced Dependency logic with Parent/Child relationships
• ... (full history continues)

⁠Support and Contribution

Developed by Level 1 Apps⁠.
For support or inquiries, visit our website. All Rights Reserved Level 1 Apps © 2025.

⁠Keywords / Tags

self-hosted, docker, task manager, productivity, local network, collaboration, lists, todo, tasks

⁠GitHub

https://github.com/l1apps/taskbox⁠