Skip to content

Troubleshooting guide

Console

A console can be useful to browse code and services.

docker compose exec -it tao /usr/bin/bash

Type exit to return to host shell.

Logs

TAO Community Edition uses journald from systemd to manage logs. Check journalctl manual for more documentation.

docker compose exec -it tao journalctl -f

Press Ctrl+C to quit log stream.

Known issues

Installation issues

This section gather common issue during installation or just after it finishes.

Username cannot login (login/password incorrect)

We consider administrator has double-checked login and password.

In rare cases, installation may face race-condition which would attempt users provisioning while the stack is not properly ready. This would mean the tao-ce.portal.init.service initialization service would consider the work done ; while it fails.

You may try one of the following solutions:

Danger

This solution will delete users and groups in TAO Community Edition, and restore defaults data.

In such case, you may have to re-run this initialization script.

  1. Enter container shell (cf. this guide)
  2. Run the following commands in tao container
# Delete semaphore to unblock users creation
rm -f $TAO_CE_VARLIB/portal/users_loaded.json
# Restart init service to recreate users
systemctl restart tao-ce.portal.init.service

Danger

This solution will delete all data, including users, groups, tests and results.

Follow re-install procedure to clean all data and re-install TAO Community Edition.