A storage addon for BlueMap that stores map data in S3-compatible storage services (Amazon S3, Cloudflare R2, MinIO, DigitalOcean Spaces, Backblaze B2, or anything else that speaks the S3 API) instead of the local filesystem.
Useful for distributed server architectures, environments without persistent local storage, and multi-server networks that need to share the same map data.
- BlueMap 5.3 or higher
- Java 21 or higher
- Access to an S3-compatible storage service
- Download the latest jar from the releases page and put it into BlueMap's
packsdirectory. - Create a storage configuration with
storage-type: "themeinerlp:s3", a bucket, an account ID or endpoint, and an access key. - Set
storagein a map configuration to that storage and restart the server. The tutorial walks through it end to end.
Start at the documentation index, or jump straight in:
- Tutorial: learn by putting a map on Cloudflare R2.
- How-to guides: solve a specific task, such as connecting to AWS S3 or MinIO.
- Reference: look up configuration keys, file locations and error messages.
- Explanation: understand why the addon works the way it does.
GNU Affero General Public License v3.0 (AGPL-3.0)
- Developed by TheMeinerLP and contributors
- Uses BlueMap by Blue
- Uses AWS Java NIO SPI for S3 for S3 filesystem integration
Open an issue on GitHub.