--- title: "Deploy Colanode" description: "Open-source Notion alternative with local-first data control." category: "Other" url: https://railway.com/deploy/colanode --- # Deploy Colanode Open-source Notion alternative with local-first data control. **[Deploy Colanode on Railway](https://railway.com/template/colanode)** - **Creator:** Rees - **Category:** Other - **Total deploys:** 14 ## Template content ### Colanode Server https://avatars.githubusercontent.com/u/185852128?s=48&v=4 - **Image:** ghcr.io/colanode/server - **Public domain:** Yes ### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg - **Image:** redis:8.2.1 - **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"` ### pgvector https://devicons.railway.com/i/postgresql.svg - **Image:** pgvector/pgvector:pg17 ### Colanode Web https://avatars.githubusercontent.com/u/185852128?s=48&v=4 - **Image:** ghcr.io/colanode/web - **Public domain:** Yes ### MinIO Console https://res.cloudinary.com/h5kvzw/image/upload/v1706062979/MINIO_Bird_vbtpet.png - **Source:** railwayapp-templates/minio-console - **Start command:** `/bin/sh -c "exec console server --host 0.0.0.0 --port $PORT"` - **Health check:** /login - **Public domain:** Yes ### MinIO Bucket https://res.cloudinary.com/h5kvzw/image/upload/v1706062979/MINIO_Bird_vbtpet.png - **Image:** minio/minio:latest - **Start command:** `/bin/sh -c "exec minio server --address [::]:$MINIO_PRIVATE_PORT $RAILWAY_VOLUME_MOUNT_PATH"` - **Health check:** /minio/health/ready - **Public domain:** Yes ## Documentation # Deploy and Host Colanode on Railway Colanode is an open-source, local-first collaboration workspace that combines real-time chat, rich text editing, customizable databases, and file management. Built with privacy and data control in mind, it enables seamless collaboration whether online or offline, similar to Notion but self-hosted. ## Getting Started After Deployment After deploying Colanode on Railway, follow these steps to configure your server and web client: ### Configure Colanode Server 1. Navigate to your Colanode Server service in the Railway dashboard 2. Go to Settings → Networking → Edit Domain → Edit Port 3. Select `3000(node)` as the port 4. Click Update 5. Visit your server domain and copy the configuration URL shown at `/config` ### Configure Colanode Web Client 1. Navigate to your Colanode Web service in the Railway dashboard 2. Go to Settings → Networking → Edit Domain → Edit Port 3. Enter `80` as the port 4. Click Update 5. Visit your web client domain ### Connect Your Server 1. On the web client, click the server selector dropdown (it's likely set to "Colanode Cloud (EU)" by default) 2. Select `+ Add new server` 3. Paste the configuration URL from your server instance 4. You should see "server added successfully" 5. Ensure your new server is selected from the dropdown 6. Click Register and enter your account details to get started ## About Hosting Colanode Hosting Colanode involves deploying a client-server architecture where the server handles data synchronization and storage while clients (web or desktop) provide the user interface. The system uses a local-first approach with SQLite for local storage and PostgreSQL for server-side persistence. Real-time collaboration is powered by Conflict-free Replicated Data Types (CRDTs) via Yjs, enabling multiple users to edit simultaneously without conflicts. The deployment requires PostgreSQL with pgvector extension, Redis for caching, and S3-compatible storage for file management. ## Common Use Cases - **Team Documentation Hub**: Create and maintain wikis, project documentation, and knowledge bases with real-time collaboration - **Project Management Workspace**: Organize tasks, timelines, and resources using customizable databases with kanban, table, and calendar views - **Secure Internal Communication**: Host private chat channels and file sharing for teams requiring data sovereignty and privacy control ## Dependencies for Colanode Hosting - **PostgreSQL with pgvector extension**: Primary database for server-side data persistence and vector operations - **Redis (or compatible service)**: Caching layer for improved performance and session management - **S3-compatible storage**: File storage backend supporting PUT, GET, and DELETE operations ### Deployment Dependencies - [Colanode GitHub](https://github.com/colanode/colanode) - Registry containing containers for server and web client - [PostgreSQL pgvector](https://github.com/pgvector/pgvector) - Vector similarity search extension for PostgreSQL - [Railway PostgreSQL Add-on](https://railway.app/template/postgres) - Managed PostgreSQL service - [Railway Redis Add-on](https://railway.app/template/redis) - Managed Redis service ### Implementation Details The Colanode server requires several environment variables for proper configuration. All variables are pre-configured in this template. The web client connects to the server via the configuration endpoint and automatically handles local SQLite database creation for offline functionality. ## Why Deploy Colanode 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 Colanode 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 - [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀 - [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform - [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy. Open this page in a browser: https://railway.com/deploy/colanode