Disable enforce-secure-profile so offline-launcher players can join

EasyAuth flagged it at startup: with enforce-secure-profile on (vanilla
default), TLauncher/offline clients are rejected before they can even
authenticate. Set ENFORCE_SECURE_PROFILE=FALSE on the mc service and
document the symptom in troubleshooting.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Aryan SinghandClaude Fable 5 committed 2026-07-10 12:34:02 -05:00
1 parent 795c2af50b
commit 85414391b0
2 files changed
+11 -4

No files matched your search

+4 -1
View File
@@ -16,8 +16,11 @@ services:
MEMORY: ${MC_MEMORY:-6G} MEMORY: ${MC_MEMORY:-6G}
USE_AIKAR_FLAGS: "true" USE_AIKAR_FLAGS: "true"
# Offline mode + whitelist as the approval gate (see docs/auth-flow.md) # Offline mode + whitelist as the approval gate (see docs/auth-flow.md).
# enforce-secure-profile must be off or offline-launcher players are
# rejected before EasyAuth can even prompt them (EasyAuth issue #68).
ONLINE_MODE: "FALSE" ONLINE_MODE: "FALSE"
ENFORCE_SECURE_PROFILE: "FALSE"
ENABLE_WHITELIST: "TRUE" ENABLE_WHITELIST: "TRUE"
ENFORCE_WHITELIST: "TRUE" ENFORCE_WHITELIST: "TRUE"
+7 -3
View File
@@ -20,12 +20,16 @@ Work down this list:
1. **"Not whitelisted"** → their username isn't approved (or the window expired and 1. **"Not whitelisted"** → their username isn't approved (or the window expired and
auto-revoked them). Access & Auth → approve/re-open. Username must match **exactly** auto-revoked them). Access & Auth → approve/re-open. Username must match **exactly**
(case matters in TLauncher). (case matters in TLauncher).
2. **Joins but immediately kicked** → they didn't `/register` or `/login` in time — 2. **Kicked with a "secure profile" / "invalid signature" style error** →
`enforce-secure-profile` must be `false` for offline launchers. The compose file
sets `ENFORCE_SECURE_PROFILE: "FALSE"`; if you edited `server.properties` by hand,
make sure `enforce-secure-profile=false`.
3. **Joins but immediately kicked** → they didn't `/register` or `/login` in time —
EasyAuth kicks unauthenticated players after a timeout. Tell them to type faster or EasyAuth kicks unauthenticated players after a timeout. Tell them to type faster or
raise the timeout in `config/EasyAuth/`. raise the timeout in `config/EasyAuth/`.
3. **"Connection timed out"** → networking: is 25565 port-forwarded? Are they using 4. **"Connection timed out"** → networking: is 25565 port-forwarded? Are they using
your *public* IP? Does `docker compose ps` show `mc` healthy? your *public* IP? Does `docker compose ps` show `mc` healthy?
4. **Wrong password loop** → Access & Auth → **Reset password**, share the temporary 5. **Wrong password loop** → Access & Auth → **Reset password**, share the temporary
one privately. one privately.
## Panel shows "Offline" but the server is up ## Panel shows "Offline" but the server is up