Browser console logs (WebUI troubleshooting)

The developer console (or browser console) is a panel built into your web browser. It records technical messages from the OliveTin WebUI—errors, warnings, and network failures—that do not always appear on the page itself.

When something looks wrong in the WebUI (for example a blank area, buttons that never load, or errors after clicking), sharing console output helps others see what the browser reported and narrow down the cause. You do not need to be a web developer to open it or share it.

A screenshot of the console is often enough. If you can copy text instead, that is helpful too. Either way, include what you were doing right before the problem (for example “opened the dashboard”, “clicked Start on action X”).

Before posting publicly, glance at the console for anything that looks like a password, token, or private URL. Crop or redact those lines if needed.

Open the console

Use OliveTin in the browser where you see the problem, then open the console before or right after reproducing the issue so the messages are still visible.

Google Chrome, Microsoft Edge, Brave, and other Chromium-based browsers

  1. Open the OliveTin page.

  2. Open the developer tools:

    • Windows / Linux: press F12, or Ctrl+Shift+J to go straight to the Console.

    • macOS: press Cmd+Option+J for the Console, or Cmd+Option+I for developer tools (then click the Console tab).

  3. If you do not see a Console tab, click » or + in the developer tools toolbar and choose Console.

Mozilla Firefox

  1. Open the OliveTin page.

  2. Open developer tools: F12, or Ctrl+Shift+I on Windows/Linux, or Cmd+Option+I on macOS.

  3. Select the Console tab. (On Windows/Linux you can also use Ctrl+Shift+K to open the console directly.)

Safari (macOS)

Safari hides the console until you turn on the Develop menu:

  1. Safari → Settings (or Preferences) → Advanced → enable Show features for web developers (wording may vary slightly by Safari version).

  2. In the menu bar, open Develop → Show JavaScript Console, or press Cmd+Option+C.

What to capture

  1. Stay on the Console tab.

  2. If there are many old messages, use the console’s Clear control so only new messages appear, then reload the page or repeat the steps that trigger the problem.

  3. Note any lines in red (errors) or yellow (warnings)—those are usually the most useful.

  4. Use your system’s screenshot tool to capture the console window, or right-click in the console → Save as… / Copy all messages if your browser offers it.

Share the logs

Attach the screenshot or pasted text to a Discord or GitHub support message, along with your OliveTin version and how you access it (direct URL, reverse proxy, etc.). That combination helps diagnose WebUI issues much faster than a description of the screen alone.

If the problem might be on the server (OliveTin not starting, actions failing, API errors), also collect service logs from Docker, Podman, or systemd.