Skip to content

Truetask Administration Guide

Truetask is a self-hosted project management platform for organizations that require full ownership of their data. It deploys entirely on your infrastructure with no external dependencies — designed for air-gapped, regulated, and security-conscious environments.

This documentation covers installation, configuration, and ongoing operations for IT administrators.

Platform Capabilities

Project Management

  • Kanban boards with drag-and-drop task management
  • List, calendar, and timeline views
  • Workflow automations triggered by card events
  • Custom fields for tracking project-specific metadata
  • Board templates for standardized project setup
  • Time tracking with timesheets and reporting
  • File attachments with S3-compatible storage

Security & Compliance

  • Self-hosted deployment — data never leaves your network
  • Air-gapped operation with zero external calls
  • Role-based access control (Owner, Admin, Lead, User, Guest)
  • Append-only audit logging with integrity verification
  • SOC 2 Type II and ISO 27001 audit report exports
  • Database encryption at rest
  • API rate limiting and session management
  • Data retention policies with automated cleanup

Identity & Access

  • Active Directory integration with user provisioning and LDAP authentication
  • OAuth 2.0 / OpenID Connect single sign-on
  • Support for multiple identity providers simultaneously
  • Hybrid authentication with automatic failover
  • Pre-provisioned accounts synced from AD group membership

Administration

  • Web-based configuration panel — no CLI required for day-to-day operations
  • Automated daily backups with configurable retention
  • S3 offsite backup storage
  • SMTP configuration for transactional email
  • Health monitoring dashboard
  • User directory with bulk provisioning
  • Per-instance branding (name, logo)

Integration

  • REST API with token-based authentication
  • Webhook support for external system integration
  • MCP (Model Context Protocol) server for AI assistant connectivity
  • Import/export for data portability

Deployment Requirements

Truetask runs as a containerized application using Docker Compose. It requires:

  • A Linux, MacOS, or Windows server with Docker and Docker Compose
  • Minimum 2 GB RAM, 10 GB disk space
  • A single exposed port (configurable, default 80)

No additional databases, message queues, or external services are required.

Getting Started