Skip to content

Running the Server

Guide for running the Authentication Test API server in different environments.

Running Options

The easiest way to run during development with hot reload:

cd API_server
mvn liberty:dev

Features:

  • Hot reload on code changes
  • Automatic test execution
  • Debug port on 7777
  • Interactive mode

Access the API at:

  • HTTP: http://localhost:9080
  • HTTPS: https://localhost:9443

Press Ctrl+C to stop.

Start the server in background:

cd API_server
mvn liberty:start

Stop the server:

cd API_server
mvn liberty:stop

See Containerization Guide for detailed instructions on running in containers with Podman or Docker.

Configuration

Set environment variables before starting:

export JWT_JWKS_URI=https://keycloak.lab.home/realms/secure-test/protocol/openid-connect/certs
export JWT_ISSUER=https://keycloak.lab.home/realms/secure-test
cd API_server
mvn liberty:dev

Verification

Test the server is running:

curl http://localhost:9080/api/v1/hello

Next Steps