Deploy Sky Free

Deploy and Host Sky Free on Railway

Sky Free is a multi-channel customer engagement platform for WhatsApp, Instagram, and web chat — unifying conversations, contacts, campaigns, and AI-powered automation into one team inbox. It supports white-label, multi-tenant deployments, so agencies can resell it under their own brand while managing multiple client workspaces from a single instance.

About Hosting Sky Free

Sky Free runs as a Node.js/Express + React application backed by PostgreSQL and Redis, deployed from one Docker image with three interchangeable roles — web server, background worker (queues, cron jobs, automation execution), and a Caddy-based reverse proxy — selected via an APP_MODE environment variable. Production deployments benefit from PgBouncer in front of Postgres for connection pooling under bursty WhatsApp webhook traffic, and Redis for sessions, queues, and multi-instance Socket.IO sync. Mobile app builds (Android/iOS via Capacitor) require Java, Gradle, and Android SDK tooling baked into the image.

Common Use Cases

• Running a WhatsApp Business / Instagram / webchat inbox with team collaboration, contact management, and campaign broadcasting
• White-labeling the platform to resell as a branded messaging and automation solution to multiple agency clients
• Building AI-agent-driven customer support or sales automation flows across messaging channels

Dependencies for Sky Free Hosting

• PostgreSQL (PgBouncer strongly recommended in front of it for connection pooling)
• Redis (required for multi-instance deployments — sessions, queues, and Socket.IO real-time sync)

Implementation Details

The app fails fast on boot in any non-development environment if required secrets are missing (server/utils/security-secrets.ts):

SESSION_SECRET=   # required — cookies, OAuth state, API-key signing
REDIS_URL=        # required — sessions, queues, Socket.IO multi-instance sync
DATABASE_URL=     # required — PostgreSQL connection string
APP_MODE=web      # web | worker | proxy | all

Why Deploy Sky Free 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 Sky Free 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.