Botpress

Development1024MB+ RAM

Open-source platform for building, deploying, and managing AI chatbots and conversational agents

Download Server Compass Install Botpress to VPS

developmentaibotpressopen-sourceself-hosteddocker

Deploy Botpress in 3 Steps

Connect Your VPS

Add your server credentials to Server Compass

Select Botpress

Choose from our template library

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required

Step-by-step deployment guide

Deploy Botpress on a VPS with Server Compass

Use the Botpress template in Server Compass to deploy a self-hosted chatbot builder on your VPS, then verify the Studio web UI.

About 10 minutesBrowser verified

Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a Botpress app

Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template

Step 3

Search for Botpress

Use the template picker search to find Botpress in the Server Compass template catalog.

Searching for Botpress in the Server Compass template picker

Step 4

Select the Botpress template

Choose the Botpress template. Server Compass fills the chatbot Studio service, persistent data volume, production environment, and public web port.

Botpress template selected in Server Compass

Step 5

Review the Botpress settings

Confirm the app name and compose service. In this run, the app was named botpress-demo and used host port 4237.

Reviewing Botpress project settings and compose service

Step 6

Deploy Botpress

Review the generated compose settings, confirm the Botpress web port is available, and click Deploy.

Reviewing Botpress web port before deployment

Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Botpress image, starts the container, and verifies the stack.

Server Compass deploying the Botpress template on the VPS

Step 8

Confirm Botpress is running

After deployment finishes, return to the Apps tab and confirm the Botpress app is marked Running with its application URL available.

Botpress template running in the Server Compass Apps tab

Step 9

Open Botpress in the browser

Open the application URL in a browser. The Botpress Studio login or first-run screen confirms the chatbot builder web UI is reachable.

The deployed Botpress web UI loaded in a browser

After Botpress Opens

Place Botpress behind HTTPS before building production chatbots.
Create the first admin account intentionally and restrict registration after setup.
Update EXTERNAL_URL to the real public URL before using embeds, OAuth callbacks, or production bots.
Protect LLM/API provider keys used by bots and rotate test keys before production.
Back up the Botpress data volume because it stores bot configuration and conversations.
Review conversation logs for PII handling before inviting real users.
Keep the Botpress image updated for dependency and security fixes.

Verified Result

The Botpress web interface loaded successfully from the deployed container.

Download Server Compass Docs

Botpress deployment questions

What does the Botpress template deploy?

It deploys the Botpress chatbot builder and Studio web UI with a persistent data volume.

Which port did the tutorial use?

The tutorial used host port 4237, which maps to the Botpress web UI on container port 3001.

Does Botpress need setup after deployment?

Yes. Create the first admin account, configure the public URL, then add bot integrations and provider keys.

Should this become a blog post?

No. The deployment guide should live on the Botpress template detail page and be linked from the reusable template deployment docs page.

After Deployment

After deploying Botpress with Server Compass, complete these steps to finish setup

Visit http://YOUR_SERVER_IP:{{PORT}} and create the super-admin account

Update EXTERNAL_URL via the app's Env Vars to the production URL when ready

Build or import a bot in Botpress Studio

Embed the chat widget on your site using the generated script tag

Need help? Check out our documentation for detailed guides.

Botpress FAQ

Common questions about self-hosting Botpress

How do I deploy Botpress with Server Compass?

Simply download Server Compass, connect to your VPS, and select Botpress from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Botpress?

Botpress requires a minimum of 1024MB RAM. We recommend a VPS with at least 2048MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Botpress data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Botpress backup and restore procedures.

How do I update Botpress to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Botpress image will be pulled and deployed with zero downtime.

Is Botpress free to self-host?

Botpress is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Related Templates

View all Development

PocketBase

Open-source backend in a single file with realtime database, auth, and file storage

Appwrite

Open-source backend-as-a-service - self-hosted Firebase alternative

Parse Server

Open-source backend framework with dashboard

Supabase

Full Supabase self-hosted with Kong, GoTrue Auth, Realtime, and Studio

Ready to Self-Host Botpress?

Download Server Compass and deploy Botpress to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass