On Prem Connector Host Linux VM

Support, Troubleshooting, & Help
1

Hello everyone,

I am currently working on creating an docker image to set up an on prem connector host locally in the company network. It should be on a Linux Virtual Machine. I however have some questions about the command that should be run to deploy the Docker image onto the Linux VM. Attached is a picture of the command that should be run based on the On-premise connector hosts guide in the Knowledge Base.

What would be the TULIP_MACHINE_SECRET argument that should be inputed in? Is there anywhere that i could get a detailed explanation of all the arguments in this command?

Best Regards,

Hazim

Tulip Docker
Tulip Docker1999×662 48.5 KB

2
Hi Hazim,

You do not generate TULIP_UUID or TULIP_MACHINE_SECRET yourself. Ask Tulip Support or your Customer Success rep for them.

Send:

  • Your factory URL

  • A name for the on prem Connector Host

  • Brief setup details (Linux VM, Docker, any proxy)

Run after you get the creds (one line):
docker run -d --name tulip-connector-host -e TULIP_FACTORY=‘https://<YOUR_FACTORY>.tulip.co’ -e TULIP_UUID=‘<FROM_TULIP>’ -e TULIP_MACHINE_SECRET=‘<FROM_TULIP>’ -e TULIP_DEVICE_TYPE=‘onprem’ -e CONNECTORS_HTTP_PROXY=‘’ -e CONNECTORS_HTTPS_PROXY=‘’ -e EXIT_ON_DISCONNECT=true --restart=always --net=host --mount type=volume,source=tuliplog,target=/log <IMAGE_REGISTRY>/public/connector-host:

Notes:

  • Set proxy vars only if you use a proxy

  • --net=host so the host can reach on prem systems

  • Optional: -e TULIP_LOG_LEVEL='debug'

  • Keep the Machine Secret private

Quick checks:

  • VM can reach Tulip over HTTPS 443

  • VM can reach your on prem targets

  • VM clock is in sync