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


The frontend dev server fails with Cannot find module '../api-output' or similar


After pulling changes from the master branch, the previously working frontend dev server fails to start


When running ./gradlew serverRun, the authentication fails with 'org.postgresql.util.PSQLException: FATAL: password authentication failed for user "teammates"'



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


When running E2E tests: Selenium cannot find Firefox binary in PATH


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.