---
title: "Deploy taskview"
description: "Self-hosted task management with Kanban, analytics, and integrations"
category: "Automation"
url: https://railway.com/deploy/taskview
---

# Deploy taskview

Self-hosted task management with Kanban, analytics, and integrations

**[Deploy taskview on Railway](https://railway.com/template/taskview)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/taskview/manifest.json

- **Creator:** kmaki's Projects
- **Category:** Automation

## Template content

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

### api

- **Image:** gimanhead/taskview-ce-api-server:1.55.0
- **Public domain:** Yes

### web

- **Image:** gimanhead/taskview-ce-webapp:1.55.0
- **Public domain:** Yes

### migration

- **Image:** gimanhead/taskview-ce-db-migration:1.55.0

## Documentation

# Deploy and Host TaskView on Railway

TaskView is a self-hosted project and task management platform for teams that need clear ownership and flexible workflows. It combines projects, tasks, Kanban boards, dependency graphs, analytics, role-based collaboration, developer integrations, webhooks, and AI/MCP connectivity while keeping application data in a PostgreSQL database you control.

## About Hosting TaskView on Railway

Railway runs TaskView as Docker image services for the web UI, API, database migration, and PostgreSQL. The web and API services use Railway domains, while API and migration services connect to PostgreSQL over Railway private networking.

## Tech Stack

- Vue web application served by Nginx
- Node.js, Express, TypeScript, and PM2 API server
- PostgreSQL with Drizzle ORM and pg-boss
- Docker images from Docker Hub and GitHub Container Registry
- Railway private networking and persistent volumes

## Why Deploy TaskView on Railway

Railway provides one-click provisioning, managed service networking, HTTPS domains, persistent PostgreSQL storage, environment variable management, and straightforward logs and redeploys. This keeps the full TaskView stack deployable without a source build while preserving the upstream container startup behavior.

## Common Use Cases

- Team project and task management
- Kanban workflows and dependency planning
- Sprint planning, time tracking, and analytics
- Self-hosted GitHub, GitLab, and Gitea integrations
- Webhook and API automation
- AI-assisted workflows through the TaskView MCP integration

## Deployment Notes

- The web service listens on port 80 and is the primary browser entry point.
- The API listens on port 1401 and is exposed through its own Railway domain for browser API calls and integrations.
- PostgreSQL listens privately on port 5432 and persists data at `/var/lib/postgresql/data`.
- The migration service runs once and exits successfully after applying database migrations; this is expected.
- JWT signing and encryption keys are generated with Railway secret functions.
- Public registration is disabled by default and password login is enabled.
- The upstream migration seeds the initial account with username `user` and password `user1!#Q`. Change these credentials immediately after the first login.
- `DEFAULT_USERNAME` and `DEFAULT_PASSWORD` are included as visible onboarding variables for the seeded account.
- The web service receives `TASKVIEW_API_URL`, while the API receives `APP_URL`, `API_PUBLIC_URL`, and `CORS_ALLOWED_ORIGINS` through Railway service references.

[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/DnZYFV)

## Dependencies for TaskView on Railway

TaskView requires the web UI, API, one-time migration runner, and PostgreSQL database. The API and migration services use private references to the PostgreSQL service, and the web UI uses the public API domain.

### Deployment Dependencies

| Service | Image | Port | Volume |
|---------|-------|------|--------|
| web | gimanhead/taskview-ce-webapp:1.55.0 | 80 | - |
| api | gimanhead/taskview-ce-api-server:1.55.0 | 1401 | - |
| migration | gimanhead/taskview-ce-db-migration:1.55.0 | - | - |
| Postgres | ghcr.io/railwayapp-templates/postgres-ssl:18 | 5432 | /var/lib/postgresql/data |

## Similar templates

- [N8N Main + Worker](https://railway.com/deploy/n8n-main-worker) — Deploy and Host N8N with Inactive worker.
- [Evolution API with n8n](https://railway.com/deploy/evolution-api-with-n8n) — Automate WhatsApp workflows with Evolution API, n8n, and Postgres.
- [Postgres Backup](https://railway.com/deploy/postgres-s3-backups) — Cron-based PostgreSQL backup to bucket storage

Open this page in a browser: https://railway.com/deploy/taskview