Steps to record a network trace (HAR file)

A network trace is a log of the communication between the browser and the server, useful to pinpoint where login or authentication errors occur.

Support generally uses this to identify where the login flow fails — for example, whether the issue is due to a network problem, a misconfigured client, or an error in Zitadel’s response.

Sample steps to create a network trace using Chrome:

Step 1: Open Chrome Developer Tools

• Navigate to the page where you want to start the trace.
• Press:
• F12 or
• Ctrl + Shift + I (Windows/Linux) or
• Cmd + Option + I (Mac)

Step 2: Go to the "Network" Tab

• In DevTools, click the “Network” tab (top of the panel).
• Make sure the red recording dot 🔴 is active.

Step 3: Enable “Preserve Log” Option

• Check the “Preserve log” box at the top.
• Check the “Disable cache” box at the top.

Step 4: Start the Trace

• Click the Clear button (⛔ symbol or right-click > Clear) to remove previous entries.
• Perform the action you want to capture

Step 5: Export the HAR File  ⬇️

Important: HAR files can include PII, you can remove this by editing the HAR file as a text file and removing passwords or any other data that could be recorded.

You can attach this file when creating a support ticket to help our team troubleshoot the issue you may be facing.