---
title: "Deploy Doccano"
description: "Open-source text, image and audio annotation tool for ML datasets"
category: "AI/ML"
url: https://railway.com/deploy/doccano
---

# Deploy Doccano

Open-source text, image and audio annotation tool for ML datasets

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

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

- **Creator:** Agaz Self-Host
- **Category:** AI/ML

## Template content

### Doccano https://raw.githubusercontent.com/doccano/doccano/v1.8.5/docs/images/logo/icon.png

- **Source:** https://github.com/aalfath/doccano-railway-template
- **Health check:** /v1/health/
- **Public domain:** Yes

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

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

## Documentation

# Deploy and Host Doccano on Railway

Doccano is an open-source annotation tool for building labelled datasets. Teams use its web interface to tag text for classification, sequence labelling (named entities), sequence-to-sequence tasks such as translation, and image or audio classification, then export the results as JSON, JSONL or CSV for machine learning training.

## About Hosting Doccano

Doccano is a Django application with a Vue web interface and a Celery worker that runs dataset imports and exports. This template builds the official `doccano/doccano` 1.8.5 image, pinned by digest, from a GitHub repo, and runs the web server and worker in one service. Projects, users, annotations and the Celery task queue are stored in Railway Postgres, and uploaded files live on a volume at `/data`. The admin account and the Django secret key are created with generated values on the first deploy, so there is no default password. Read `ADMIN_PASSWORD` in the Doccano service's Variables tab, then sign in at your Railway domain.

## Common Use Cases

* Labelling text for sentiment, topic or intent classification models
* Tagging named entities and spans to train NER and information-extraction models
* Collecting translations, summaries or image and audio labels with a team of annotators

## Dependencies for Doccano Hosting

* Railway Postgres (database and Celery task queue)
* A Railway volume mounted at `/data` for uploaded files

### Deployment Dependencies

* Doccano source and releases: https://github.com/doccano/doccano/releases
* Doccano documentation: https://doccano.github.io/doccano/
* Template repo (Dockerfile, start script, changelog): https://github.com/aalfath/doccano-railway-template

### Implementation Details

* Sign in with `ADMIN_USERNAME` (default `admin`) and `ADMIN_PASSWORD`. Doccano resets the admin's password to `ADMIN_PASSWORD` on every start, so change it in the Variables tab and redeploy.
* There is no public sign-up. Create annotator accounts in the Django admin at `https://YOUR-DOMAIN/admin/`, then add them to projects with a role.
* Optional settings you can add yourself: `WORKERS` and `CELERY_WORKERS` (2 each by default), `MAX_UPLOAD_SIZE`, and `EMAIL_HOST`, `EMAIL_PORT`, `EMAIL_HOST_USER`, `EMAIL_HOST_PASSWORD`, `EMAIL_USE_TLS` for email.
* Health check: `/v1/health/` reports the database, Celery, file storage and migrations.
* Updates: merges to the template repo's `main` show up as an update in your project. Read the repo's CHANGELOG and back up Postgres before applying one.

## Why Deploy Doccano on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Doccano on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.



## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [Weaviate](https://railway.com/deploy/weaviate-1) — Vector database with hybrid search and an API key-protected API
- [Möbius Personal AI OS](https://railway.com/deploy/mobius-v01-personal-ai-os) — Self-hosted AI agent that builds and runs apps for you, with memory.

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