Skip to content

docs: add network hosting and reverse proxy troubleshooting (@isma-021)#7970

Merged
Miodec merged 1 commit into
monkeytypegame:masterfrom
isma-021:patch-docs-self-hosting
May 19, 2026
Merged

docs: add network hosting and reverse proxy troubleshooting (@isma-021)#7970
Miodec merged 1 commit into
monkeytypegame:masterfrom
isma-021:patch-docs-self-hosting

Conversation

@isma-021
Copy link
Copy Markdown

Description

I noticed that when trying to host Monkeytype over a local network or the internet instead of localhost, the frontend crashes with an Uncaught TypeError: crypto.randomUUID is not a function error. This happens because modern browsers restrict this API to secure contexts (HTTPS).

When putting a reverse proxy in front to handle HTTPS, it's very easy to run into Mixed Content blocks or 404 errors due to incorrect .env configurations (like adding a trailing slash to MONKEYTYPE_FRONTENDURL or forgetting to completely recreate the containers).

This PR updates SELF_HOSTING.md to:

  • Explain the HTTPS requirement for network deployments.
  • Detail how to properly configure the backend URL in the .env file to avoid API 404 errors (the trailing slash issue).
  • Highlight the importance of using docker compose up -d --force-recreate and clearing the browser cache, since environment variables are baked into the SPA static files at startup.

Checks

  • Make sure the PR title follows the Conventional Commits standard. (https://www.conventionalcommits.org for more info)
  • Make sure to include your GitHub username prefixed with @ inside parentheses at the end of the PR title.

Added instructions for hosting over HTTPS and troubleshooting frontend connection issues.
@monkeytypegeorge monkeytypegeorge added the docs Related to Markdown files and documentation label May 19, 2026
@Miodec
Copy link
Copy Markdown
Member

Miodec commented May 19, 2026

Thanks!

@Miodec Miodec merged commit bcf95c1 into monkeytypegame:master May 19, 2026
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Related to Markdown files and documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants