Deploy Doccano
Open-source text, image and audio annotation tool for ML datasets
Just deployed
/data
Just deployed
/var/lib/postgresql/data
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
/datafor 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(defaultadmin) andADMIN_PASSWORD. Doccano resets the admin's password toADMIN_PASSWORDon 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:
WORKERSandCELERY_WORKERS(2 each by default),MAX_UPLOAD_SIZE, andEMAIL_HOST,EMAIL_PORT,EMAIL_HOST_USER,EMAIL_HOST_PASSWORD,EMAIL_USE_TLSfor email. - Health check:
/v1/health/reports the database, Celery, file storage and migrations. - Updates: merges to the template repo's
mainshow 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.
Template Content

