Sign inSign up

tryformation/formation-agent

By tryformation

Updated over 1 year ago

Tryformation agent to connect your asset tracking to the FORMATION API.

Image
Internet of things
0

1.6K

tryformation/formation-agent repository overview

The FORMATION agent allows you to connect your Omlox/Deephub, and other asset tracking hardware to FORMATION.

For whom is this?

If you have an on premise installation of Deephub (or one of the other supported modules), you can connect it to FORMATION using the FORMATION Agent. It runs locally in a docker container and connects to your on-premise Deepub to forward reported locations to FORMATION.

Prerequisites

  • FORMATION workspace ID and an API token (contact us for this: https://tryformation.com).
  • Ability to run the docker container somewhere in your network.
  • Ability to connect to the FORMATION Api from that network.

Example usage

version: "2.3"
services:
  formation-agent-deephub:
    image: tryformation/formation-agent:1.0.15

    environment:
      # give your profile a name, the agent can run mulitiple profiles
      active_configurations: yourprofilename-deephub

      ENV: local-yourprofilename-deephub
      environment: yourprofilename-deephub

      # the settings below this are for your environment and prefixed with yourprofilename-deephub.

      # this configures the OmloxDeepHub integration
      yourprofilename-deephub.module_id: OmloxDeepHub
      # measurements below this threshold are not forwarded
      yourprofilename-deephub.movement_threshold_in_meters: 0.25
      yourprofilename-deephub.workspace_id: xxx
      # API token for the FORMATION API
      yourprofilename-deephub.api_token: xxx
      # proxy settings for formation API
#      yourprofilename-deephub.proxy_type: http
#      yourprofilename-deephub.proxy_host: 172.17.7.191
#      yourprofilename-deephub.proxy_port: 80
#      yourprofilename-deephub.proxy_user: 01_svc_DeepHub_proxy
#      yourprofilename-deephub.proxy_password: fIUuJrax912_fN7Dzvh1rHvKe
      # deephup configuration
      yourprofilename-deephub.websocket_url: wss://domain.com/deephub/v1/ws/socket
      # Deephub keycloak endpoint for getting a token
      yourprofilename-deephub.auth_url: https://domain.com/realms/omlox/protocol/openid-connect/token
      # Deephub client id & secret
      yourprofilename-deephub.client_id: xxx
      yourprofilename-deephub.client_secret: xxx

    mem_limit: 512m

Tag summary

Content type

Image

Digest

sha256:c02d1058d

Size

258.2 MB

Last updated

over 1 year ago

docker pull tryformation/formation-agent