Create and Install a Connector

This tutorial shows you how to create a connector in the Connector Factory and install the connector on your machine.

1. Navigate to the Connector Factory

Go to Connector Factory. You will be prompted to link your Octoblu account to the Connector Factory. Once authenticated, you can view the Dashboard, My Things, and All Things.

The Dashboard shows your recently installed connectors and the Top Connectors.
The My Things shows your installed connectors and things.
The Available Connectors shows the available connectors you can install on your machine.

2. Select a Connector to Create

View the Available Connectors and select one from the list.

3. Select the Connector Version

Select the version you would like to install, I always recommend using the latest.

4. Download the Installer

By now you should be redirected to download the Installer. You are given a few options. Click the button for the OS you are running. Currently we provide the following options:

macOS
Linux x64
Linux x86
Windows x64
Windows x86

If you already have downloaded an installer recently, you can copy the OTP (One Time Password) and paste it into the Installer.

5. Open the Installer

mac OS:

Open the DMG
Open the Installer in mounted image

Linux:

Unzip the Installer whilst maintaining the folder name.
- Use the "Extract Here" option when right clicking the zip file.
Open the App in the extracted folder

Windows:

Unzip the Installer whilst maintaining the folder name.
- Use the "Extract All" option when right clicking the zip file.
Open the App in the extracted folder
- IMPORTANT - make sure to choose option: "Run as Administrator" when launching.

6. Begin the Install

Click the "Begin Install" button
Wait until the Installer is done. If you run into problems, view the debug information and contact us via the support icon in the

7. Configure the Connector

Going back to the Connector Factory, you can now configure the device. This can either be done by going back to the "Next Step" on the download page. Or you can find your connector in the My Things and click the "Configure" action.

While on the configure page you should see the following statuses:

"connector is running" - means your connector is responding to pings and is in a running state
"connector is responding to pings" - means your connector is responding to pings but may not be running.
"thing is online" - means the connector is connected to meshblu
"thing is offline" - means the connector is offline
"connector error" - means your connector responded to a ping with an error.

8. Use it in a Flow

Your installed connector is now available as a Thing in app.octoblu.com. Add and use the connector in the designer.