Appearance
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
- Installation — deploy Truetask on your server
- Licensing — activate your license
- SMTP — configure email delivery
- Active Directory — sync users from AD
- OAuth / SSO — configure single sign-on
- Backup & Recovery — protect your data
- Security — harden your deployment