How do I deploy BrowserBird on Railway?

You can deploy BrowserBird on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: browser-bird-674b6421, or click "Get template help" for this template for more assistance.

Deploy and Host BrowserBird on Railway

BrowserBird is a self-hosted AI agent for Slack with a real Chromium browser, a cron scheduler, and a web dashboard. Talk to an AI agent in Slack threads. It can browse the web using Playwright MCP with a real Chromium browser you can watch live through a built-in VNC viewer, run scheduled tasks, and keep persistent sessions across conversations. The agent CLI handles reasoning and tools; BrowserBird is the orchestration layer.

About Hosting BrowserBird

BrowserBird runs as two containers: an app service (Node.js API, Slack connection, web dashboard) and a VM service (Chromium browser, Wayland compositor, VNC). The app service needs a persistent volume at /app/.browserbird for its SQLite database and config. On first launch, a web-based onboarding wizard walks you through Slack app setup, agent configuration, and API keys. No manual config files needed. The VM service runs a headless desktop environment with Chromium, accessible through the web dashboard's built-in VNC viewer. Allocate at least 2 vCPU and 4 GB RAM for the VM service to keep Chromium stable.

Common Use Cases

Chat with an AI agent in Slack that can browse the web, fill forms, and take screenshots using a real browser
Schedule recurring AI tasks (called "birds") on a cron to monitor pages, generate reports, or collect data
Run a shared AI assistant for your team with persistent conversation history and a live browser you can watch

Dependencies for BrowserBird Hosting

A Slack workspace with a configured Slack app (bot token and app-level token)
An Anthropic API key or Claude OAuth token for the agent CLI

Deployment Dependencies

Slack app setup guide - Create a Slack app using the provided manifest
Anthropic API - Get an API key for the agent CLI
BrowserBird documentation - Full configuration reference

Why Deploy BrowserBird 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 BrowserBird 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.