Installation guide

Hello 🙂

Today we show you how to install our Clairvoyance application.

For this cause we wrote an installation guide in our README.md file.

If you want to try it out by yourself, just follow the guide!

SaSEp: Clairvoyance

Installation guide

Prerequisites

  • Postgres database (You can use our preconfigured test database as defined in application.properties)
  • Keycloak (our instance is preconfigured)
  • NodeJS
  • Maven
  • Java JDk
  • Git

Installation

Backend

  • Git clone the backend repository: [email protected]:sasep-clairvoyance/sasep-backend.git
  • CD into the directory.
  • Change server port to 9000 in /resources/application.properties.
  • Run mvn package
  • Run java -jar target/swagger-spring-1.0.0.jar

Frontend

  • Git clone the frontend repository: [email protected]:sasep-clairvoyance/sasep-frontend.git
  • CD into the directory.
  • Change the environment variable VUE_APP_SASEP_API_URL to the backend URL http://localhost:9000 in .env.development
  • Run ““npm install“`
  • Run npm run serve
  • Access the frontend with: localhost:8080

Done. You have a running Clairvoyance instance.

See you in the next one!

Bye 🙂

Join the Conversation

3 Comments

  1. Hi SaSEp-Team 🙂
    I tried out your guide! I successfully managed to install your application.

    So the backend app was installed very fast and without any problems. I’ve been really surprised.
    Then I had some minor problems with your frontend but that was my mistake 😀 I just missed “npm install” before “npm run serve”. (Maybe you can add this line to your guide..?).
    Now your app works so smooth…. 🙂

    In the end some small criticism on a very high level: Your preconfigured Keycloak realm that I’ve been using hasn’t configured my domain as redirect_uri, so I couldn’t log in. But that’s fine. As we are using Keycloak within our project too, we could have used our preconfigured instance instead of yours.

    So… pretty cool! Nice guide, nice app.

    Best wishes,

    Jeanne from bookly

    1. Hey Jeanne,

      thank you for testing our application.

      I added the missing “npm install”. Good catch!

      I also added localhost as valid redirect_uri in our keycloak instance, so this should work as well now.

      Greetings,
      Jan

Leave a comment

Leave a Reply to Jan Hansel Cancel reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.