What each connection field means

August 17, 2026 · View on GitHub

One distinction makes the rest of this page easier:

!!! tip "Bridge profiles and direct RCON describe different endpoints" With the normal Bedrock or Java bridge setup, Address, Port, and Secret key describe the Admincraft WebSocket bridge. Only Direct RCON describes the Minecraft server itself. The app relabels these fields when you change the connection type.

This is the part that catches people out. With a bridge profile, a Java server's RCON port and password belong in the bridge configuration, not in Admincraft. A direct RCON profile is intentionally different.

The fields

FieldWhat it isWhere the value comes from
AliasA label for your own benefit. Shown in the server picker.Anything you like.
Minecraft editionWhich kind of server the bridge should drive. Bedrock uses the container console; Java uses RCON.Match your server.
AddressThe machine running the websocket container. The label changes with the connection type, and names the Minecraft server instead for direct RCON.Tailscale address, ts.net hostname, or public IP.
Bridge portThe port the bridge listens on.8080 normally, 443 behind Tailscale Funnel.
Bridge access keyThe bridge key used to sign the token Admincraft sends. Its configured scope determines available controls.ADMIN_SECRET_KEY, COMMAND_SECRET_KEY, READ_ONLY_SECRET_KEY, or legacy SECRET_KEY in the bridge environment.
Connection typeWhich setup you have. The address and port fields relabel themselves to match.See connection security, or direct RCON.

Why Java does not ask for RCON details

Choosing Java Edition changes which backend the bridge uses, not where Admincraft connects. The RCON host, port and password are configured on the bridge:

  websocket:
    environment:
      SECRET_KEY: YOUR_SECRET_KEY_HERE   # legacy full-access bridge key
      RCON_HOST: minecraft
      RCON_PORT: "25575"
      RCON_PASSWORD: CHANGE_THIS_RCON_PASSWORD

RCON stays on the internal Docker network and is never published to a host port. That is deliberate: RCON has no encryption, so exposing it would hand out server control in plain text.

In this bridge setup, the edition selector describes your server and the RCON password stays on the server host. Direct RCON below deliberately sends the password from the installed app over your private network instead.

Direct RCON, with no bridge

A Java server can be reached without the bridge at all: Admincraft opens an RCON connection straight to it. Choose Direct RCON, no bridge as the connection type, and the fields then describe the Minecraft server rather than a bridge.

FieldValue
Minecraft editionJava Edition
Address of the Minecraft serverthe server, over Tailscale, a VPN or a LAN
RCON port25575, or whatever rcon.port in server.properties says
RCON passwordthe rcon.password from server.properties
Connection typeDirect RCON, no bridge (Java only)

Enable it on the server first:

enable-rcon=true
rcon.port=25575
rcon.password=a-long-random-password

!!! danger "Never expose the RCON port to the internet" RCON has no encryption whatsoever. The password and every command you send cross the network in clear text, and anyone who can reach the port can try passwords at will. Put it on Tailscale, a VPN or a LAN and leave it closed to the public internet. If the server is remote, this mode removes the bridge but not the need for a private network.

Two further limits:

  • Not available in the browser. RCON is a raw TCP protocol and a web page cannot open one. The option is hidden in the web app; use the Windows, macOS, Linux or Android build, or the bridge.
  • No live console. RCON answers commands and pushes nothing, so the terminal shows command replies only. Player joins and leaves never appear, and the player list has to be refreshed with list rather than watching for events. The bridge streams the real server log, so choose it if you want to watch the console.

Worked example: Bedrock over Tailscale Funnel

The setup from the Bedrock guide:

FieldValue
Minecraft editionBedrock Edition
Addressmy-server.tailnet-name.ts.net
Bridge port443
Bridge access keyone of the scoped bridge keys, or legacy SECRET_KEY
Connection typePublic address, trusted certificate

The address preview under the dropdown should read wss://my-server.tailnet-name.ts.net:443.

Worked example: Java on a private Tailscale network

FieldValue
Minecraft editionJava Edition
Address100.101.102.103
Bridge port8080
Bridge access keyone of the scoped bridge keys, or legacy SECRET_KEY
Connection typePrivate network (Tailscale, VPN or LAN)

The preview reads ws://100.101.102.103:8080. That is unencrypted by design, and safe only because Tailscale already encrypts the route. It will not work from the hosted web app: see using the web app.

If it will not connect

Work down the chain, since each step rules out everything before it:

  1. Is the preview the address you expect? It is shown live under the security dropdown.
  2. Is the port the bridge's port? Not 19132 (Bedrock game), not 25575 (Java RCON).
  3. Is the key one configured by the bridge? Use an admin, command, read-only, or legacy key—not the RCON password or Minecraft allowlist.
  4. Does the connection type match the address? Private network gives ws:// and only works over a private route. For Public certificate, use the exact hostname or IP address covered by the certificate; a hostname is the usual and most portable choice.
  5. Can the device reach the host at all? With Tailscale, both ends must be on the tailnet and connected.