Tailscale Authentication For Minecraft

Xe Iaso and TJ Horner on
Photo of Xe Iaso
Photo of TJ Horner

You can do many things with computers. Some of them are more productive than others. My recent blog post shows how to authenticate to any service, such as Grafana. Some people took the idea of using Tailscale for authenticating to any service as a neat fact. Others took this as a challenge to come up with even more creative applications of Tailscale for authentication. This is the story of one of the latter cases. This is how you can make your Minecraft server join your tailnet and authenticate to it with Tailscale.

One big question you may be asking is, “Why on earth would you want to do this?” I would like to counter this with another question: “Why not?” As a great man has said, “Science isn’t about ‘why?’ it’s about ‘why not?’” We take this philosophy seriously at Tailscale.

Putting your Minecraft server into your tailnet with Tailscale for authentication gives you these advantages:

This also comes with a fairly large set of disadvantages too:

This works by creating an authentication proxy much like we did before with Grafana. The proxy will listen for traffic on your tailnet and then forward it to the Minecraft server with one notable exception. At the beginning of a Minecraft session, the client will send the server a packet that contains the username of the person trying to log in.

Normally the server is supposed to take the contents of that packet and check it against Mojang authentication servers to ensure that you are actually logged in as that username in your Minecraft launcher. The server will then allow or deny the connection based on the result. Instead of relying on Mojang for authentication, by using Tailscale we can rely on Tailscale for authentication. If we also had Mojang for authentication, the proxy will look up Tailscale identity information for that Minecraft session and replace the Minecraft username the client gave you with the user information from Tailscale—but Mojang’s authentication servers will have no idea what to do with this. We just bypass them with offline mode in Minecraft, which does not require any authentication.

After the authentication dance, the proxy will forward Minecraft traffic like any other proxy. Then you can mine and craft to your heart’s content with the people you trust. You will be able to chat with your co-workers and create great things together.


If you want to set up this on your tailnet, you will need to use the patched version of the proxy infrared. Infrared is normally used by Minecraft server networks to host giant Minecraft servers that can scale up to thousands of total players at once, but it’s also generic enough that we can use it to proxy to a simple vanilla Minecraft server.

Set up everything as you would normally with infrared, but be sure to set the environment variable TS_AUTHKEY to a brand new authkey. If you tag the key, your Minecraft server’s node key will not expire, so it stays connected to your tailnet, allowing you to craft and mine forever!

Something to keep in mind is that infrared will want you to connect with the full domain name of the Minecraft server. It is very picky about this. We will use the MagicDNS domain that every tailnet gets for free. Assuming your Minecraft server is on port 25565, copy the following into configs/tailscale.json:

  "domainName": "minecraft-proxy.$your-account-domain-name.beta.tailscale.net",
  "listenTo": ":25565",
  "proxyTo": ""

You can find this domain out by going to the DNS settings page and looking for the domain that ends in .beta.tailscale.net—it should be your account’s domain followed by .beta.tailscale.net. Add minecraft-proxy. at the beginning of this to get your full domain name.


Be sure to set server-ip to and server-port to 25565 in your server.properties file so that it’s not listening on the public internet:


If you have other inventive ideas for things we can do with computers, reach out to us on Twitter @Tailscale or head to our forum to tell us the horrors beyond description that you have created.

The forging of this beautiful creation was thanks to the efforts of TJ Horner. I hope this was enlightening.

Share via

Subscribe for monthly updates

Product updates, blog posts, company news, and more.

Too much email? RSS Twitter