Developer Troubleshooting Guide

This guide covers common problems encountered while setting up and contributing to TEAMMATES.

Common setup errors and solutions

The backend server fails with java.io.FileNotFoundException


The backend server is "stuck" at 85% EXECUTING or alike


PSQLException: FATAL: password authentication failed for user 'teammates' when connecting to database


Backend fails to start with org.hibernate.tool.schema.spi.SchemaManagementException



Common test errors and solutions

A handful of failed E2E test cases (< 10)


java.net.ConnectException: Connection refused when running E2E tests


org.openqa.selenium.WebDriverException: Unable to bind to locking port 7054 within 45000 ms when running tests with Browser


On Linux: java.io.IOException: Directory "/tmpfiles" could not be created



Submitting help request

If none of the above helps, post in GitHub Discussions with as much relevant information as possible.