Like the Dex login test, email confirmation needs external services. CI starts Mailpit and a separate mail-enabled API before Playwright. Tests connect through MAILER_API_URL (default http://127.0.0.1:3457/api/v1) and MAILPIT_URL (default http://127.0.0.1:8025). The main test API keeps mail disabled.

For local runs, start Mailpit in one terminal:

docker run --rm --name vikunja-e2e-mailpit \
  -p 127.0.0.1:1025:1025 -p 127.0.0.1:8025:8025 axllent/mailpit:v1.31.1

From the repository root, start the mail-enabled API in another terminal:

mage build
mail_test_root=$(mktemp -d)
mkdir -p "$mail_test_root/files"
VIKUNJA_SERVICE_INTERFACE=127.0.0.1:3457 \
VIKUNJA_SERVICE_PUBLICURL=http://127.0.0.1:4173/ \
VIKUNJA_SERVICE_ROOTPATH="$mail_test_root" \
VIKUNJA_FILES_BASEPATH="$mail_test_root/files" \
VIKUNJA_DATABASE_TYPE=sqlite VIKUNJA_DATABASE_PATH=memory \
VIKUNJA_AUTH_OPENID_ENABLED=0 VIKUNJA_REDIS_ENABLED=0 \
VIKUNJA_MAILER_ENABLED=1 VIKUNJA_MAILER_HOST=127.0.0.1 \
VIKUNJA_MAILER_PORT=1025 VIKUNJA_MAILER_FORCESSL=0 \
./vikunja web
rm -rf "$mail_test_root"

Then run the tests from the repository root, fixing the frontend port so the confirmation links point to the test frontend:

VIKUNJA_E2E_FRONTEND_PORT=4173 mage test:e2e 'tests/e2e/user/registration.spec.ts'

Stop Mailpit and the mail-enabled API when finished.