How to setup Dynmap on your server

Category Plugins Last updated Oct 16, 2026 3 min read

How to Install and Use Dynmap on Your Minecraft Server

Dynmap is a Spigot plugin that gives you a Google Maps-style view of your server from a website. Players can open the map in their browser and see your world, buildings, and where players are. This guide shows you how to install Dynmap and how to open the map.

Before You Begin

A Minecraft server running Spigot (or a compatible server such as Paper)
Access to the AleForge Panel
An additional port for your server (see below)

You Need an Additional Port

Dynmap runs its own web server, so it needs its own port. If you want to use Dynmap, you will have to request an additional port from support. Keep the port number support gives you, because you will use it during setup.

Disk Space

Note: Dynmap can take up a significant amount of space on your server, depending on the size of your world. Keep an eye on your disk usage, especially if your world is large.

Installing Dynmap

Download Dynmap.
Go to the AleForge Panel and select your server.
Stop your server.
Make sure your server is running the correct Minecraft version of Spigot for the version of Dynmap you downloaded.
Open File Manager.
Upload Dynmap to the plugins folder.
Start your server and join your world. This is needed so Dynmap can generate its configuration files.
Go back to File Manager and open plugins/dynmap/configuration.txt.
Change webserver-port to the new port you were given by support.
```
webserver-port: 25598
```
Restart your server.

The port above is an example only. Use the port you received from support.

Accessing Dynmap

Go to the AleForge Panel.
Open Network and take note of your server’s IP address.
Type the IP address of your server into your browser, followed by a colon and your port. For example:
```
123.45.67.89:25598
```
If you are using a custom domain, point it to this address.
You will now be on the Dynmap page for your server.

Tips

The map starts empty and fills in over time. Dynmap draws the map as areas get explored and rendered, so it may look blank at first. You can also use the /dynmap fullrender command to render your whole world, but this can use a lot of CPU and disk space on large worlds.
Use the right version. Dynmap must match your Minecraft version. Check the plugin page if the map doesn’t load.
Back up first. Make a backup before adding new plugins, just in case.

Troubleshooting

Problem	What to try
The page won’t load	Check that the port in `configuration.txt` matches the port from support, that you restarted the server, and that you typed the port after the IP.
`configuration.txt` isn’t there	Make sure you started the server and joined the world after installing the plugin, then check `plugins/dynmap/` again.
The map is blank	Wait for Dynmap to render, or run `/dynmap fullrender`.
The plugin doesn’t load	Check the Console for errors and make sure your server version matches the Dynmap version.
The server is running out of disk space	Dynmap map tiles can be large. Delete old tiles or remove Dynmap if you don’t need it.