Frequently Asked Questions

Answers to the most common questions about TaskView.

General

What is TaskView?

TaskView is an source-available, self-hosted project and task management platform. It provides Kanban boards, dependency graphs, team collaboration with role-based access control, GitHub/GitLab integration, and a dashboard - all running on your own infrastructure.

Is TaskView free?

Yes. TaskView Community Edition is free (see LICENSE) and source-available under the license.

What is the difference between TaskView and SaaS tools like Trello or Asana?

TaskView is self-hosted - you run it on your own server. Your data never leaves your infrastructure. There are no subscriptions, no vendor lock-in, and no third-party access to your project data. You get full control over backups, updates, and security.

Who is TaskView for?

TaskView is designed for teams and individuals who need task management with full data ownership. It works well for small teams, startups, freelancers, security-conscious organizations, and anyone who prefers self-hosted tools.

Installation and Deployment

How do I install TaskView?

TaskView runs as a set of Docker containers. You need Docker and Docker Compose installed, then create two environment files and a docker-compose.yml. The whole setup takes about 5 minutes. See the Installation guide for step-by-step instructions.

What are the system requirements?

You need a server or local machine with Docker and Docker Compose. TaskView runs on any platform that supports Docker - Linux, macOS, or Windows. Minimum recommended: 1 CPU core, 1 GB RAM, 10 GB disk space.

Can I run TaskView on a VPS?

Yes. TaskView works on any VPS provider (Hetzner, DigitalOcean, AWS EC2, Linode, etc.). Deploy with Docker Compose and put a reverse proxy (Nginx, Caddy, or Traefik) in front for SSL termination. See the deployment guide for a detailed walkthrough.

How do I update TaskView?

Run docker compose pull followed by docker compose up -d. The migration container automatically applies any database changes on startup.

Does TaskView support HTTPS?

TaskView itself serves HTTP. For HTTPS, use a reverse proxy like Nginx or Caddy in front of the TaskView containers to terminate SSL. This is the recommended production setup.

Features

Does TaskView have Kanban boards?

Yes. Each project has a Kanban board with customizable status columns. Drag and drop task cards between columns to update their status. See Kanban Board for details.

Can I track task dependencies?

Yes. TaskView has an interactive dependency graph where you can link tasks and visualize the relationships. This helps identify bottlenecks and plan the order of work. See Dependency Graph.

Does TaskView support subtasks?

Yes. Any task can have subtasks for breaking work into smaller steps. Subtasks are lightweight - they have a title and a completion state.

Can I attach files to tasks?

Currently, TaskView does not support file attachments. You can add links and descriptions in the task notes using the rich text editor.

Does TaskView have time tracking?

TaskView does not include built-in time tracking. It focuses on task management, Kanban workflows, and team collaboration.

Does TaskView support financial tracking?

Yes. You can attach a monetary amount to any task and mark it as income or expense. This is useful for freelancers and teams that need basic budget tracking alongside task management.

Team and Collaboration

How do I invite team members?

Open a project, go to the Collaboration tab, and enter the person's email address. They need to have a TaskView account with that email. See Team Members.

Does TaskView have role-based access control?

Yes. TaskView has a granular RBAC system with 28 permissions covering tasks, lists, Kanban, graphs, members, and integrations. You create roles, assign permissions, and assign roles to users. See Roles and Permissions.

Can different team members have different permissions?

Yes. Permissions are per-project. You can create roles like "Developer", "Manager", and "Viewer" with different permission sets, and assign them to team members independently in each project.

Integrations

Can I connect GitHub repositories?

Yes. TaskView can sync issues from GitHub repositories as tasks. You connect via OAuth, select a repository, and issues are imported and kept in sync via webhooks. See GitHub & GitLab Setup.

Can I connect GitLab repositories?

Yes. GitLab integration works the same way as GitHub - OAuth authorization, repository selection, and webhook-based sync. Both cloud and self-hosted GitLab instances are supported.

Does TaskView have an API?

Yes. TaskView has a REST API that powers both the web app and mobile apps. The API uses JWT authentication and is fully documented in the source code.

Security and Data

Where is my data stored?

All data is stored in a PostgreSQL database on your server. The pgdata Docker volume contains the database files. No data is sent to external services.

How do I back up my data?

Back up the PostgreSQL pgdata Docker volume. You can use standard PostgreSQL backup tools like pg_dump or volume-level backups depending on your infrastructure.

Are OAuth tokens stored securely?

Yes. GitHub and GitLab integration tokens are encrypted at rest using AES-256-GCM with a key you provide via the ENCRYPTION_KEY environment variable.

Mobile

Does TaskView have mobile apps?

Yes. TaskView has Android and iOS apps built with Capacitor. They connect to your self-hosted server and sync your tasks, projects, and notifications.

• iOS (App Store)
• Android (Google Play)

Can I use TaskView in a mobile browser?

Yes. The web interface is responsive and works in mobile browsers, though the native apps provide a better experience.