Docker Static Maps Hosting Live In 5 Minutes

Docker Static Maps hosting on xCloud gives you a self-hosted REST API that renders static map images with markers, polygons, circles, polylines and text overlays. Deploy Docker Staticmaps v0.11.8 and xCloud runs the pinned official image behind HTTPS with a generated API key, a read-only container and no storage to manage, ready for emails, reports and printed documents in just a few minutes.

Deploy your Docker Static Maps

No terminal
No technical skills needed
No lock-in, cancel anytime

What is Docker Static Maps?

Self-hosted Docker Staticmaps is a self-hostable REST API for rendering static map images, described by upstream as including tile caching, per-IP rate limiting and optional API key authentication. Its README lists markers, polygons, circles, polylines and text overlays, multiple basemaps such as OpenStreetMap, Esri and Carto, custom tile servers and an optional hillshade overlay. It is a self-hosted alternative to the Google Static Maps API and Mapbox Static Images, licensed AGPL-3.0-or-later.

On xCloud the template runs mxdcodes/docker-staticmaps v0.11.8, pinned by digest, as one stateless container: a read-only root filesystem, dropped capabilities and a process limit, with the tile cache held in memory. Every request needs the generated API key, only the health check is open, and the server fetches tiles from public providers over HTTPS.

From Sign-Up to a Live Static Maps API In Just 3 Easy Steps

Self-hosting a static maps renderer normally means a container, an API key to generate and guard, a domain and a certificate before a single map renders. This is the same result without assembling any of it.

Step 01
Sign Up
Create your xCloud account and pick Docker Static Maps from the OneClick catalog. Choose a domain, and leave the API Key field empty to have one generated, or enter your own.
Step 02
We Deploy It For You
One click. We bring up the pinned Docker Static Maps 0.11.8 image, generate the API key, and publish the API and demo page over HTTPS on your domain.
Step 03
Call The API
Open the Demo Page Link from your installation credentials to try maps in the browser, then call the /api/staticmaps endpoint with the key in an x-api-key header from your own servers and scripts.

Everything Docker Static Maps Does, On Your Own Server

Docker Static Maps runs in full here — markers, shapes, text, basemaps and output formats, on infrastructure you control.

Maps For Non-Interactive Places
Generate map images for emails, PDFs, dashboards and link previews, where an interactive map can't run.
Markers, Shapes And Text
Draw markers, polygons, circles, polylines and text overlays in one request, by query string or JSON POST.
Choice Of Basemap
Pick from several basemaps — OpenStreetMap, Esri, Carto — use your own tile server, or add an optional hillshade overlay.
Multiple Output Formats
Output PNG, JPEG, WebP or PDF at the size you need, straight from the API response.
Key-Protected, Rate-Limited
Every request needs the generated API key, with a per-visitor rate limit and in-memory tile caching to keep it responsive.
Stateless By Design
Nothing to back up — the API key and settings are the same after an xCloud restart, since there's no database to lose.

Everything You Need To Run Your Map Rendering 24/7

Managed hosting for Docker Static Maps, so the parts that keep it online are not your problem.

Docker Static Maps 0.11.8 deployed instantly
API key generated for you
Per-visitor rate limiting
Multiple basemaps and output formats
Free SSL certificate
Server backups and snapshots
Server security updates included
30+ server locations
Unused balance refunded

What You Can Do With Docker Static Maps

A self-hosted static map generator for emails
A developer renders a map image with a marker for each order or event and drops the PNG into emails and reports, without calling a paid maps service for every message.
Draw routes and areas
An analyst overlays polylines, polygons and circles on a basemap, or adds text labels, and exports the result as PNG, JPEG, WebP or PDF for a document.
Choose your own tile source
An operator picks OpenStreetMap, Esri or Carto tiles, or points the API at a custom tile server, and tunes caching so repeated maps are served quickly.
Call it from scripts with a key
A script sends the x-api-key header with a request to the API path and saves the image, while the per-IP rate limit protects the instance from runaway callers.

Docker Static Maps vs Alternatives

Google Static Maps API: Choose Docker Static Maps as a Google Static Maps alternative when you want the renderer on your own Cloud VPS. It draws tiles from the providers you choose, such as OpenStreetMap, Esri or Carto; this is a category comparison only.
Mapbox Static Images API: Docker Static Maps is a Mapbox Static Images alternative that you host yourself, with an API key you generate and tiles fetched from the provider you choose. Check that provider's terms for your volume.
OpenStreetMap tile servers: The public OpenStreetMap tile servers return an Access blocked placeholder to clients that do not identify themselves. This API fetches tiles for you, and you set TILE_USER_AGENT so a busy instance identifies itself properly.
Embedded map widgets: An interactive map widget needs JavaScript in the reader's browser, which email clients do not run. A static image from this API works anywhere an image does, including emails, PDFs and printed reports.

Simple Pricing. Everything Included.

Dedicated Cloud VPS sizes, pre-configured for Docker Static Maps hosting. Pick the one that fits, and resize any time.

Cloud VPS 6 GB

Cloud VPS 16 GB

Higher render volume and bigger batch jobs.

$59.99per month

16 GB RAM
6 vCPU cores
200 GB NVMe SSD
30 TB
Unlimited

Get started

Cloud VPS 24 GB

Docker Static Maps alongside a whole API stack.

$84.99per month

24 GB RAM
8 vCPU cores
300 GB NVMe SSD
30 TB
Unlimited

Get started

Every size is a dedicated Cloud VPS we provision, patch, monitor and restore. Billed monthly with no lock-in — delete the server and the unused balance comes back to your account. Docker Static Maps itself is free under the AGPL-3.0-or-later licence.

Docker hosting

Already Have a Server? Bring Your Own

Connect any VPS — DigitalOcean, Vultr, Linode, AWS, Hetzner or bare metal — and deploy Docker Static Maps on it through the same panel, for a per-server management fee instead of a Cloud VPS rental.

Free

Start your journey without cost.

$0forever

1 server
10 sites

Start free

Starter

Professional

The same platform, discounted at 6–10 servers.

$4per server / month

6–10 servers
Unlimited sites
All features included
Bring any VPS provider

Get started

Agency

The same platform, discounted at 11+ servers.

$3per server / month

11+ servers
Unlimited sites
All features included
Bring any VPS provider

Get started

Priced per connected server, so your rate adjusts automatically as you add or remove servers. You pay your own provider for the server itself.

Self-managed hosting

Ready To Render Your Own Map Images?

Docker Static Maps on xCloud runs on a dedicated Cloud VPS that we provision, patch, monitor and restore. Deploy faster. Own the server. Stay in control.

Fast Provisioning
Deploy faster using an xCloud Managed Server built with optimized stacks and high-speed SSDs.
Enterprise-grade security
Protect your infrastructure with a free SSL certificate and more advanced security features at no additional cost.
Intuitive Control Panel
From Server creation to application deployment, everything can be managed from our intuitive control panel.

Hear what people are saying about us

See why agencies, developers, startups, and growing businesses choose xCloud to power their projects.

xCloud works really well, I am surprised by its performance being this the release version, I have tried many paid platforms such as runcloud, cloudpages or serveravatar, as well as free platforms such as CyberPanel, CloudPanel or Hestia Control Panel and direct competitors such as SpinupWP and FlyWP. Of all those that I have tried, the platform that works best for WordPress is SpinupWP and I believe that xCloud can reach and surpass that development, its roadmap is promising. Congratulations to the xCloud team, I hope they become the leading platform in the segment, it has all the potential to achieve it!

Brian Geovanny

I've been with runcloud for the last 3 years. However, after trying xcloud for the last month, I'm switching over. They are on a roll with their setup.

Kevin Pineda

I'm moving my servers to xCloud, a cloud control panel by M Asif Rahman and the WPDeveloper team. Their roadmap looks interesting and no, there are no team mates nor API limits with xCloud! #xCloud #wordpress #hosting

Leo Koo

How Cloud Nine Web Elevated Client Experience While Streamlining Hosting Operations using xCloud

Ed Ellingham

xCloud is like having an expert server team on call — without the big agency costs. It's given me back my time and given my clients peace of mind. Highly recommended for freelancers and small teams who want reliable performance and security.

Dumitru Butucel

xCloud isn't just a solution. It's like one of that friend who got your back when you screw things up pretty bad.

Waqar Ahmed

Trust me when I say, once people explore the potential of xCloud they gonna switch from other panels, just keep delivering the best tech, lots of love for the team 😍😍

Rahul Singh

So far my experience has been smooth like silk. I didn't imagine that configuring and managing a VPS would be so easy. As of today, I have deployed 8 sites. The support is good, and they treat users with respect, even if they ask stupid questions (myself included). For the future, I hope for greater flexibility in scheduled backups and more comprehensive and consistent documentation. I'm sure that within a few months, xCloud will become the leader in its segment. This community is amazing, and the Staff here is super helpful.

Massimo Villa

Came from cloudways then to runcloud then to xcloud. Looks like I'm staying here.

Gerson El

I've recently taken all of my Vultr-hosted sites and gotten rid of cPanel for them to substitute it with xCloud. I have to say, I'm really impressed with xCloud so far! The interface is definitely the standout feature for me.

Tony Lewis

I came from Cloudways and won't go back. Highly impressed with xCloud. Glad I gave them a chance.

Jared McDowell

I like xCloud better than RunCloud, but one thing I'll point out is that some years ago RunCloud was hungry for business, the support was outstanding, and the community was active and helped each other. Maybe it was sold, there was a change in management, or they stopped being hungry, but the quality of the RunCloud offering declined and it hasn't been moving forward quickly. My point is that currently the xCloud team has the edge and it is theirs to keep or lose

David McCan

How Kevin Heinrichs Cut Hosting Costs by 84% While Running WooCommerce & Node.js Sites Efficiently

Kevin Heinrichs

I had 150 sites on cloudways and am in the process of moving them to xcloud. Much faster and better priced.

Dan Spinoza

Dear xCloud Team, I have been using xCloud for some time now and am genuinely impressed with its capabilities and the flexibility it offers by allowing users to bring their own VPS for management. It's a fantastic service, and my experience so far has been very positive. Successful migrated 5 sites on a single server. Xcloud migration tool worked great. There were few hiccups with security plugin like MalCare but disabling the plugin prior to migration worked just fine.

Rahil Maknojia

Came from runcloud. Tried xcloud and never came back.

Karl Fanega

How Advanced Web Strategies Saved Over $2,000 & Recovered 56 Hours per Month Managing 70+ Client Websites

Gary Moody

xCloud gave me what no other hosting platform could: the flexibility of a VPS with the convenience of managed WordPress. As a solo founder running an entire business on one server, that combination is an important unfair advantage.

Jorge de los Reyes Martínez

I use Server Avatar and xCloud and I'll sooner use xCloud than Server Avatar personally.

Jay Pagano

How Newman Web Solutions Ensured Perfect Uptime and Seamless Scaling For 120+ WordPress Sites with xCloud

Lori Newman

I too have moved over to xCloud. It's pretty sweet. One click n8n and uptime Kuma apps

John Aperture

I went from Cloudways to xCloud. No intention on switching in the foreseeable future.

Blaine Moore

Frequently Asked Questions

Feel free to contact us with any questions or concerns you may have.

Is Docker Static Maps open source?

Yes. Upstream is licensed AGPL-3.0-or-later with the source available at its repository, so the renderer carries no licence charge. xCloud bills for the dedicated Cloud VPS. Tile providers have their own usage terms to check.

Can you self-host Docker Static Maps with Docker?

Yes, and this template does it for you: the official mxdcodes/docker-staticmaps v0.11.8 image, pinned by digest, as one stateless container behind HTTPS. It is Docker Staticmaps Docker hosting with a read-only filesystem and dropped capabilities, without a compose file to write.

Docker hosting on xCloud

How much RAM does Docker Static Maps need?

The manifest floor is 512 MB of RAM, so the 6 GB Cloud VPS sold here suits a Docker Staticmaps cloud install. The app is stateless: the tile cache and rate-limit counters live in memory and reset on restart.

How do I generate a static map image with an API call?

Send a request to the staticmaps API path with width, height, centre as latitude and longitude, zoom and optional markers, carrying your key in the x-api-key header, and save the response as a file. The credentials panel shows a demo page link.

Which tile provider does it use?

Upstream lists multiple basemaps, including OpenStreetMap, Esri and Carto, and custom tile servers. The server needs outbound HTTPS to reach them. OpenStreetMap can serve an Access blocked placeholder to anonymous clients, so set TILE_USER_AGENT to identify your deployment.

How do I protect a static maps API key?

Treat it like a password. Every API request must carry the key, preferably in the x-api-key header, because a key in a query parameter can be recorded in logs and browser history. Rotate it by changing API_KEY in the Environment editor and redeploying.

Can it render markers and polygons?

Yes. Upstream lists markers, polygons, circles, polylines and text overlays, an optional hillshade overlay, and output in PNG, JPEG, WebP or PDF. Coordinates are given as latitude and longitude. JSON and form request bodies are limited to 100 kb by default.

Is there an OSM static map API I can host myself?

This is one. It renders static maps from OpenStreetMap and other tile sources behind your own HTTPS domain and API key. It is not an interactive tile server; it fetches tiles from public providers and composes them into the image you ask for.

How do I back up Docker Static Maps?

There is no volume to back up: the template creates none and the app is stateless. Your configuration is the optional environment lines, so note those down along with the API key. Redeploying recreates the container from the same pinned image.

How do I upgrade Docker Static Maps?

Upgrades are manual. v0.11.8 is fixed by digest and catalogue changes reach new installs only. Read upstream's notes, then adopt a newer Docker Static Maps template version when one is published, and request a test map. The tile cache is rebuilt after the restart.

Can I cancel anytime?

Yes. There is no lock-in — cancel any time. Hosting is billed monthly and charged for what you actually use, so when you delete the server the unused balance is refunded to your account, less up to 10% in payment-processing fees.