Logs and diagnostics
Download Portal and lab logs, inspect a container and prepare a useful support report.
Download logs from Portal
- Reproduce the problem once and note the time, including your time zone.
- Open Settings / Download Logs. This collects an archive of Portal and lab service logs.
- Keep the exact error text and note the lab, service and action involved.
- Include the installed Portal version and your operating system when reporting the problem.
Save the logs before resetting or replacing the lab. Those actions can remove the state needed to understand what happened.
If Portal will not open
Use Docker from a terminal on the host. List containers, find the relevant name, then read its recent output. Replace CONTAINER_NAME with the name shown on your machine.
docker ps -a
docker logs --timestamps --tail 200 CONTAINER_NAMEFor a standard Compose installation, run the following from the Portal installation folder. The output is scoped to that Compose project.
docker compose ps -a
docker compose logs --timestamps --tail 200Send a useful report
- What you tried, what you expected and what happened.
- Exact message or error code, if one is displayed.
- Portal version, operating system and Docker version.
- Lab name, affected service, time of failure and whether it happens again.
- The relevant log archive or a short log excerpt.
Review logs before sharing. Remove passwords, tokens and unrelated private data. Use a private support channel for a full archive.
