Back to all templates
Drizzle Gateway logo

Drizzle Gateway

Development256MB+ RAM

Self-hosted database studio and HTTP gateway by the Drizzle team — browse, query, and proxy your databases from a web UI

developmentdevtoolsdrizzlegatewayopen-sourceself-hosteddocker

Deploy Drizzle Gateway in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Drizzle Gateway

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Drizzle Gateway on a VPS with Server Compass

Use the Drizzle Gateway template in Server Compass to deploy a self-hosted database studio and HTTP gateway on your VPS, then verify the unlock UI.

About 10 minutesBrowser verified
1
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 Drizzle Gateway 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 Drizzle Gateway

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

Searching for Drizzle Gateway in the Server Compass template picker
4
Step 4

Select the Drizzle Gateway template

Choose the Drizzle Gateway template. Server Compass fills the gateway service, data volume, master password, and public web port.

Drizzle Gateway template selected in Server Compass
5
Step 5

Review the Drizzle Gateway settings

Confirm the app name and compose service. In this run, the app was named drizzle-gateway-demo and used host port 4186.

Reviewing Drizzle Gateway project settings and compose service
6
Step 6

Deploy Drizzle Gateway

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

Reviewing Drizzle Gateway web port before deployment
7
Step 7

Watch the deployment progress

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

Server Compass deploying the Drizzle Gateway template on the VPS
8
Step 8

Confirm Drizzle Gateway is running

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

Drizzle Gateway template running in the Server Compass Apps tab
9
Step 9

Open Drizzle Gateway in the browser

Open the application URL in a browser. The Drizzle Gateway unlock screen confirms the protected database studio is reachable.

The deployed Drizzle Gateway web UI loaded in a browser

After Drizzle Gateway Opens

  • Store MASTERPASS in a password manager; it protects registered database connections.
  • Place Drizzle Gateway behind HTTPS, VPN access, or an authenticated reverse proxy.
  • Do not expose saved database connections directly to the public internet.
  • Back up the Drizzle Gateway data volume to preserve saved connections and queries.
  • Use least-privilege database users for each registered connection.
  • Test with a disposable database connection before adding production credentials.
  • Keep the Drizzle Gateway image updated for security and compatibility fixes.

Verified Result

The Drizzle Gateway web interface loaded successfully from the deployed container.

Drizzle Gateway deployment questions

What does the Drizzle Gateway template deploy?

It deploys Drizzle Gateway as a protected web UI for browsing, querying, and proxying database connections.

Which port did the tutorial use?

The tutorial used host port 4186, which maps to the Drizzle Gateway web UI on container port 4983.

Does Drizzle Gateway need setup after deployment?

Unlock the UI with MASTERPASS, add a disposable database connection, and verify a simple SELECT before adding production credentials.

Should this become a blog post?

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

After Deployment

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

1

Visit http://YOUR_SERVER_IP:{{PORT}} and unlock with MASTERPASS

2

Add a database connection via the Connections tab (host, port, user, password, ssl)

3

Open the SQL runner and verify you can SELECT against the target database

4

(Optional) Configure team access and HTTP gateway tokens for read-only API access

Need help? Check out our documentation for detailed guides.

Drizzle Gateway FAQ

Common questions about self-hosting Drizzle Gateway

How do I deploy Drizzle Gateway with Server Compass?

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

Drizzle Gateway requires a minimum of 256MB 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 Drizzle Gateway data?

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

How do I update Drizzle Gateway to the latest version?

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

Is Drizzle Gateway free to self-host?

Drizzle Gateway 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 Drizzle Gateway?

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

Download Server Compass