Skip to content

mTLS

Adds support for mTLS to Minecraft

NeoForge
Loaders
NeoForge
Downloads on Modrinth
76
Followers on Modrinth
1
versions
4
Updated
August 1, 2026Aug 1
Published
in 2026

At a glance

Runs on NeoForge
For Minecraft 1.21.1–1.21.11, 26.2
Needed in the game and on the server
Latest version — 0.1.2 from August 1, 2026
License GPL-3.0-or-later — free
Where it's needed
In gamerequiredOn serverrequired

Needed both in the game and on the server

Game versions1.21.1–1.21.11, 26.2

Minecraft TLS (mTLS)

Adds Mutual TLS (mTLS) support to Minecraft. Encrypts traffic and acts as a strict player allowlist using certificates - only players with a valid client certificate can connect.

Made so friends don't need to install external tools like stunnel.


🛠️ Server Setup

Place your certificates in config/mtls_server/:

  • ca.crt (CA certificate)
  • server.crt (Server certificate)
  • server.key (Server private key, PKCS#8 format)

Using an Nginx SSL Reverse Proxy? You still need this mod on the server to disable vanilla Minecraft encryption.

  1. Edit config/minecrafttls-common.toml and set alwaysDisableVanillaEncryption to true.
  2. Do not place certificates in config/mtls_server/ (this disables the mod's native TLS so Nginx can handle it).

🖥️ Client Setup

Configure mTLS settings directly in the server edit screen:

mTLS Server Config Screen mTLS Server Connection Details


📌 Versions

  • Supported: NeoForge 1.21.1, 26.2
  • Planned: Fabric & newer/older MC versions

FAQ

How to install mTLS?

Install NeoForge for your Minecraft version, download mTLS for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does mTLS support?

mTLS has builds for Minecraft 1.21.1–1.21.11, 26.2.

Is mTLS needed on the server?

Needed in the game and on the server

License and source
GNU General Public License v3.0 or laterfree to use and share; changes to the mod itself must be published under the same license
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More