decerto/higson-studio repository overview

⁠Higson Studio

Higson Studio (API and UI on Tomcat server) Docker container. Only postgresql driver is included.

⁠Running container

Requirements :

• Running database (oracle/mssql/mysql/postgres/h2)

Use below docker-compose.yml to run container:

version: "3.7"

services:
  higson-studio:
    image: decerto/higson-studio:${HIGSON_STUDIO_VERSION}
    container_name: higson-studio
    ports:
      - "38080:38080"
    volumes:
      - "${DATABASE_DRIVER_PATH}:/usr/local/tomcat/lib/db-driver.jar"
    environment:
      - "HIGSON_DATABASE_URL=${JDBC_URL_TO_RUNNING_DB}"
      - "HIGSON_DATABASE_USERNAME=${DB_USERNAME}"
      - "HIGSON_DATABASE_PASSWORD=${DB_PASSWORD}"
      - "HIGSON_STUDIO_SECURITY_TOKEN_VERIFICATION_SECRET_KEY=${SECRET_KEY}" 
    networks:
      - higson-net

networks:
  higson-net:
    driver: bridge

Variables to set:

• HIGSON_STUDIO_VERSION - existing Higson Studio image version (tag), ex: 4.0.1
• DATABASE_DRIVER_PATH - path to your database driver file if different from h2 or postgresql, ex: /drivers/mssql-driver/mssql-jdbc-12.2.0.jre11.jar
• JDBC_URL_TO_RUNNING_DB - JDBC URL to your running database, ex: jdbc:postgresql://higson-db:5432/higson?currentSchema=public
• DB_USERNAME - database username
• DB_PASSWORD - database password
• HIGSON_STUDIO_SECURITY_TOKEN_VERIFICATION_SECRET_KEY - key used to generate JWT, as default it is sha256 key (HIGSON_SECURITY_JWT_SECRET_KEY in 4.0.x version).

After running Higson Studio will be available at: http://localhost:38080/higson/app/⁠

⁠Additional configuration

Application properties can be also configured by passing application.properties file, ex:

...
    volumes:
        - /configuration/application.properties:/usr/local/tomcat/conf/application.properties
...

⁠Documentation

Complete documentation available at: https://www.higson.io/docs/start-documentation⁠