Quant-UX

This is the Quant-UX server backend. To run this you need a MongoDB server and a folder where images are stored.

You can try out a running version here: https://quant-ux.com

Config

Edit the config file (e.g. matc.conf). Do not forget to update the jwt.password property. For a clustered setup, you need to keep the passwords the same. If you keep the password blank, a random password is generated at startup

{
  "debug" : false,
  "http.port" : 8080, // The server port
  "http.host": "your.server.com", // The domain name of your server. This is important for the mail that will be send. Otherwise links will not work
  "image.folder.user" : "test/user", // folder where user images will be stored
  "image.folder.apps" : "test/apps", // folder where app images will be stored
  "image.size" : 50000000, // max image size for uploads
  "mongo.db_name": "MATC", // mongo DB to use
  "mongo.connection_string": "mongodb://localhost:27017", // connection string, might include password and username
  "mail.user": "", // POP user name for mail sending
  "mail.password" : "", // password or token
  "mail.host": "", // URL of mail server
  "mail.port": 587, //  optional, port of mail server, default is 587
  "mail.ssl": 'required', //  possible values 'required','optional' or 'disabled'. required is default.
  "admin": "[email protected]", // Internal mails will be send to this persons
  "jwt.password": "test", // JWT password
  "auth.service": "", // 'keycloak' or ''
  "auth.keycloak.server": "",
  "auth.keycloak.realm": "",
  "auth.keycloak.claim.lastname": "",
  "auth.keycloak.claim.name": "",
  "auth.keycloak.claim.id": "",
  "auth.keycloak.claim.email": "",
  "user.allowSignUp": true,
  "user.allowedDomains": "*"
}

You can also provide the configuration through ENV variables. The following variables are supported, and map to the JSON definitions.

    QUX_HTTP_HOST

    QUX_HTTP_PORT
    
    QUX_MONGO_DB_NAME

    QUX_MONGO_TABLE_PREFIX

    QUX_MONGO_CONNECTION_STRING

    QUX_MAIL_USER

    QUX_MAIL_PASSWORD

    QUX_MAIL_HOST
    
    QUX_MAIL_PORT

    QUX_MAIL_SSL
    
    QUX_JWT_PASSWORD

    QUX_IMAGE_FOLDER_USER

    QUX_IMAGE_FOLDER_APPS
    
    QUX_AUTH_SERVICE

    QUX_KEYCLOAK_REALM

    QUX_KEYCLOAK_SERVER

    QUX_KEY_CLOAK_CLAIM_ROLE

    QUX_KEY_CLOAK_ISSUER

    QUX_KEY_CLOAK_CLAIM_ID

    QUX_KEY_CLOAK_CLAIM_EMAIL

    QUX_KEY_CLOAK_CLAIM_NAME

    QUX_KEY_CLOAK_CLAIM_LASTNAME
    
    QUX_USER_ALLOW_SIGNUP
    
    QUX_USER_ALLOWED_DOMAINS

Please note that we have replaced the old config of nested objects with a straight dot notation.

Private deployments

You can limit the domains from which user can sign up by setting the 'user.allowedDomains' parameter in the config file, or by setting the ENV variable 'QUX_USER_ALLOWED_DOMAINS'. The value must be a comma separated list of domains, e.g. 'my-server.com,your-host.com'. Please be aware of . Sub-domains will be allowed.

Mongo optimization

Start the mongo shell and run the following commands to set the correct mongo indexes

use MATC
db.app.createIndex({"isPublic":1})
db.app.createIndex({"isDirty":1})

db.event.createIndex({"appID":1, "type":1})
db.event.createIndex({"appID":1})

db.mouse.createIndex({"appID":1})
db.team.createIndex({"userID": 1})
db.team.createIndex({"appID":1})
db.image.createIndex({"appID":1})
db.team.createIndex({"userID": 1, "appID":1,"permission":1 })
db.content.createIndex({key:1})
db.appevent.createIndex({"created":1})

db.invitation.createIndex({"hash": 1})
db.invitation.createIndex({"appID":1})
db.commandstack.createIndex({"appID":1})
db.comment.createIndex({"appID":1})
db.testsetting.createIndex({"appID":1})
db.user.createIndex({"email":1})
db.user.createIndex({"id":1})

Development

You might need a mongo server. The simplest way is to use Docker.

docker run -p 27017:27017 --name quxmongo2 -d mongo:4.4   

Start server

java -jar server-3.20.0-fat.jar -conf matc.conf -instances 4

Dev Setup

In InteliJ create a new runner with the following parameters:

• Main Class: io.vertx.core.Starter

• Program Arguments: run com.qux.MATC -conf matc.conf

Connection with KeyCloak

docker run -p 8081:8080 -e KEYCLOAK_USER=admin -e KEYCLOAK_PASSWORD=admin -v $(pwd)/test/keycloak:/tmp --name qux-keycloak jboss/keycloak 

docker run -p 8081:8080 -e KEYCLOAK_USER=admin -e KEYCLOAK_PASSWORD=admin -e KEYCLOAK_IMPORT=/tmp/example-realm.json -v  $(pwd)/test/keycloak/example-realm.json:/tmp/example-realm.json --name qux-keycloak  jboss/keycloak