Logs & Debugging

Download diagnostics

Sign in as an administrator. In Settings → General → Diagnostics, choose Download diagnostics to save a ZIP of recent server logs and system information. If your installed version does not have this option, use the Docker commands below.

Diagnostics stay on your server for up to seven days, within a 100 MiB limit. Credentials, URLs, and file paths are filtered. Nothing is submitted automatically.

Send the ZIP with a description of what happened, approximately when, and the browser or app involved. Share it directly with support when possible rather than posting it publicly.

Chrome or Edge may block the ZIP when you open your server over HTTP. Open your browser’s Downloads panel, check that it is the Norri diagnostics ZIP you requested from your own server, then choose Keep. If your server already has an HTTPS address, use that address.

Viewing server logs

For the Docker installation, run:

docker logs --since 15m norri

To follow new messages while reproducing a problem:

docker logs -f norri

Replace norri if your container has a different name. On Unraid, open the Norri container’s menu and choose Logs.

Extra diagnostic detail

Normal logging uses LOG_LEVEL=info. Routine request and playback trace messages are hidden at this level, while warnings, errors, and security events remain available.

If support asks for more detail, set LOG_LEVEL=debug in the container’s environment and apply the change. Reproduce the problem once, collect the relevant log section, then restore LOG_LEVEL=info and apply it again. Applying environment changes restarts the container, so do this when nobody is watching.

Sharing logs

Include the time of the problem, what you were doing, your server version, and the browser or app involved. A short section covering the failure is usually more useful than days of output.

Norri redacts authentication credentials in its application request and playback logs. Logs can still include filenames, local paths, network addresses, and library details. Check the excerpt before posting it publicly, and do not include passwords or complete authenticated streaming URLs. Reverse proxies and other services have their own logging settings.

Use the issue tracker to report the problem. Choose Server, Web player, Client app, or Not sure as appropriate.