Back to all templates
Roundcube logo

Roundcube

Infrastructure512MB+ RAM

Browser-based IMAP webmail client - connects to an existing mail server

infrastructureemailroundcubeopen-sourceself-hosteddocker

Deploy Roundcube in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Roundcube

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Roundcube on a VPS with Server Compass

Use the Roundcube template in Server Compass to deploy a self-hosted webmail client on your VPS, then verify the Roundcube login UI in a browser.

About 7 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select your 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 Roundcube app
2
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
3
Step 3

Search for Roundcube

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

Searching for Roundcube in the Server Compass template picker
4
Step 4

Select the Roundcube template

Choose the Roundcube template. Server Compass fills in the webmail service, IMAP host, SMTP host, MySQL database password, and root password.

Roundcube template selected in Server Compass
5
Step 5

Review the Roundcube settings

Confirm the app name and compose services. In this run, the app was named roundcube-demo and used host port 4201.

Reviewing Roundcube project settings and compose services
6
Step 6

Deploy Roundcube

Review the generated environment values, confirm the port is available, and click Deploy Now.

Reviewing Roundcube environment variables and port before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Roundcube image, starts MySQL, initializes the webmail files, and verifies the stack.

Server Compass deploying the Roundcube template on the VPS
8
Step 8

Confirm Roundcube is running

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

Roundcube template running in the Server Compass Apps tab
9
Step 9

Open Roundcube in the browser

Open the application URL in a browser. The Roundcube login UI confirms the webmail client is reachable.

The deployed Roundcube webmail login UI loaded in a browser

After Roundcube Opens

  • Replace the placeholder IMAP_HOST and SMTP_HOST values with your real mail server settings.
  • Use ssl://host:993 or tls://host:587 style host strings when your mail server requires encrypted connections.
  • Configure HTTPS before exposing Roundcube publicly.
  • Back up the MySQL and Roundcube web data volumes because they store preferences, contacts, and drafts.

Verified Result

The Roundcube webmail login page loaded successfully in a browser.

Roundcube deployment questions

What does the Roundcube template deploy?

It deploys Roundcube with MySQL as a browser webmail front end for an existing IMAP and SMTP mail server.

Which port did the tutorial use?

The tutorial used host port 4201, which maps to the Roundcube web service on container port 80.

Why does the guide stop at the login page?

Roundcube is a mail client. The tutorial verifies that the login page loads; real mailbox login depends on the IMAP and SMTP server you configure.

Should this become a blog post?

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

After Deployment

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

1

Visit http://YOUR_SERVER_IP:{{PORT}} and log in with an email account hosted on {{IMAP_HOST}}

2

If login fails, double-check `ROUNDCUBEMAIL_DEFAULT_HOST` and `ROUNDCUBEMAIL_SMTP_SERVER` in the compose file - use `ssl://host:993` or `tls://host:587` syntax for encrypted connections

3

Customize the appearance and plugins by editing `/var/www/html/config/config.inc.php` (or mounting a custom config file)

4

Configure HTTPS in front of Roundcube before exposing it publicly

Need help? Check out our documentation for detailed guides.

Roundcube FAQ

Common questions about self-hosting Roundcube

How do I deploy Roundcube with Server Compass?

Simply download Server Compass, connect to your VPS, and select Roundcube 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 Roundcube?

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

Can I migrate my existing Roundcube data?

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

How do I update Roundcube to the latest version?

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

Is Roundcube free to self-host?

Roundcube 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.

Ready to Self-Host Roundcube?

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

Download Server Compass