Repository files navigation

Structures is an open-source framework for data storage and retrieval, supporting schema evolution, data management, and providing a user-friendly GUI and OpenAPI interface for data management.

• https://kinotic-foundation.github.io/structures/

• structures-core
  • Provides the core library for use in all other projects.
• structures-frontend
  • Provides a GUI for interacting with Structures.
• structures-server
  • Provides Access to the core library via a REST API and a GUI.

1. Install Docker Desktop.
2. Install SdkMan, which makes installing/managing Java and Gradle easy. Also can manage multiple installed versions.
   1. curl -s "https://get.sdkman.io" | bash
3. Install Java 11
   1. sdk install java 11.0.17-zulu
4. Build the Docker images (Get a cup of ☕ this could take a bit the first time, depending on your internet connection.)
   1. ./gradlew bootBuildImage
5. Publish the image to docker

   export DOCKER_HUB_USERNAME=<your docker hub username>export DOCKER_HUB_PASSWORD=<your docker hub password>   ./gradlew bootBuildImage --publishImage

6. Run Docker Compose.
   1. cd docker-compose && docker-compose up -d (You should see the application listed under containers in docker desktop)
7. You can now view the application by goinghere in a browser. (This may not be available for at least a minute while the backend services finish starting.)
   1. http://localhost:9090/

These variables are available for custom configuration, presented are the defaults.

STRUCTURES_INDEX_PREFIX: struct_STRUCTURES_TENANT_ID_FIELD_NAME: structuresTenantIdSTRUCTURES_ELASTICCONNECTIONS_0_SCHEME: httpSTRUCTURES_ELASTICCONNECTIONS_0_HOST: elasticsearchSTRUCTURES_ELASTICCONNECTIONS_0_PORT: 9200STRUCTURES_ELASTIC_CONNECTION_TIMEOUT: 5sSTRUCTURES_ELASTIC_SOCKET_TIMEOUT: 60sSTRUCTURES_ELASTIC_USERNAME:STRUCTURES_ELASTIC_PASSWORD:STRUCTURES_OPEN_API_SECURITY_TYPE: BASICSTRUCTURES_OPEN_API_PORT: 8080STRUCTURES_OPEN_API_PATH: /api/STRUCTURES_OPEN_API_SERVER_URL: http://127.0.0.1:8080STRUCTURES_GRAPHQL_PORT: 4000STRUCTURES_GRAPHQL_PATH: /graphql/STRUCTURES_CORS_ALLOWED_ORIGIN_PATTERN: '*'STRUCTURES_WEB_SERVER_PORT: 9090STRUCTURES_HEALTH_CHECK_PATH: /health/STRUCTURES_ENABLE_STATIC_FILE_SERVER: trueSTRUCTURES_INITIALIZE_WITH_SAMPLE_DATA: false