You might not need to install this software. This software is used by the FarmBot team and advanced users who run their own FarmBot servers. We highly recommend that you use our publicly hosted server at my.farmbot.io, which elimintes the need for server setup.
Farmbot uses MQTT for realtime events. On the device side, this is handled over a TCP connection to the MQTT broker. On the browser, this is performed over a Websocket connection.
- Log in to the broker using the same email as on the web app. A JSON Web Token from the API can be used as a password.
- Messages are sent using JSON RPC.
bot/{ BOT_UUID }/request
: User initiated command objects are sent here.bot/{ BOT_UUID }/response
: Successfully completed commands are reported on this channel.bot/{ BOT_UUID }/notification
: Messages that were not initiated by the user are sent here. Eg: logs and statuses.bot/{ BOT_UUID }/error
: Failed commands are reported to this channel.
Subscribing to bot/{ BOT_UUID }/*
via 3rd party MQTT client (Such as MQTT FX) is useful for debugging and monitoring.
- git clone THIS_REPO
- cd THIS_REPO
- npm install
- node index.js
- Visit
http://localhost:3000
ormqtt://localhost:1883
The MQTT broker uses ENV vars as the main means of configuration. These must be set properly for the app to work.
MQTT_WEBSOCKET_PORT
: Optional. WebSocket connection port. We recommend using 3002. NOTE If you are using standard MQTT, that is always port 1883. Raise an issue if you need to run MQTT on a different port.WEB_APP_URL
: URL to your FarmBot API. For instance, if you were running the API locally, you would set this value tolocalhost:3000
- Start the FarmBot API on your local machine on default port.
- Run
npm run dev
See setup_notes.md
.
- Technically, port
3002
and1883
could be hard coded. The translation could be handled by HAProxy.