Biketeam

Use project

Prerequisites

Install Java

Version 17 or above

Start components

docker compose up -d

Configure OAuth2

To handle authentication, you'll need :

• Strava (mandatory)
• Google (optional)
• Facebook (optional)

Declare and configure your app in these providers to get Oauth2 Client ID and Client Secret

Get a SMTP provider

You'll need to configure a SMTP for biketeam to send mail (check out Mailjet if you don't have one).

Docker Compose provides MailHog on this URL for local tests.

Get a Mapbox Key

Go to Mapbox and get a developer key.

Configuration

Copy .env.template to .env and replace first lines values, including REMEMBERME_KEY.

Run

To enable logging in a file, use --logging.file.name=/path/to/log/file as a command line argument.

With Maven

Biketeam is a standard spring boot application so use spring boot maven plugin.

mvn spring-boot:run

In IDE

Run BiketeamApplication class with main method.

Executable jar

Run mvn clean package then execute the biketeam.jar

java -jar biketeam.jar

.env file must be next to the jar file.

Docker Compose

Run mvn clean package -Pdocker then execute

docker compose -f docker-compose.yml -f docker-compose.biketeam.yml up -d

/opt/biketeam MUST exist.