signalk-fomofleet

A Signal K server plugin that reports vessel position, engine state, and voyage data to FomoFleet.com — a captain's log and fleet tracking service.

Voyages are logged automatically when your engines are running. Position, speed, heading, and engine telemetry are streamed in real time and visible on your FomoFleet dashboard from any device.

Prerequisites

• A Signal K server running on your vessel (Raspberry Pi, NUC, or similar always-on computer)
• Your vessel's 9-digit MMSI number
• A free account at fomofleet.com

If you don't have Signal K installed yet, follow the Signal K server setup guide first, then come back here.

Quick Start

1 — Create a FomoFleet account

Sign up at fomofleet.com. After registering, check your email and click the verification link to activate your account.

Tip: Check your spam/junk folder if the email doesn't arrive within a couple of minutes.

2 — Add your vessel

After logging in, click Vessels in the sidebar, then Add Vessel. Enter your vessel's MMSI number and click Look up vessel.

Your MMSI appears on the front of most VHF radios, or in the radio's menu under "MMSI" or "DSC Setup."

3 — Claim ownership

Open your vessel's detail page and click Claim ownership. This is required before a Tracker ID can be assigned.

4 — Create a Tracker ID

Click Trackers in the sidebar, then Add a Tracker and select your vessel. A unique Tracker ID is generated — copy it, you'll need it in the next step.

The Tracker ID is a long unique code like b7f4375f-4239-49f0-.... Keep it private — anyone with this ID can send data for your vessel.

5 — Install the plugin

On your Signal K server, go to Apps & Plugins → Appstore and search for signalk-fomofleet. Click Install and wait for it to complete.

6 — Configure the plugin

Go to Apps & Plugins → Plugin Config and open signalk-fomofleet. Set two fields:

| Field | Value | |---|---| | Engine Configuration | Single or Twin depending on your vessel | | Tracker ID | The code you copied in Step 4 |

Click Save.

7 — Restart and verify

Click Restart in Signal K. After about a minute the plugin status bar will turn green and display the current state — for example:

State: NUW, Prt: STPD, OK

Your vessel is now reporting live to FomoFleet. Voyages are created automatically when your engines start and closed when they stop.

If the status stays blank after a few minutes, check the Signal K server log for errors from signalk-fomofleet.

What the plugin reports

• Position — latitude, longitude, heading, speed over ground
• Engine state — running / stopped per engine (port and starboard)
• Voyage boundaries — start and end events used to create log entries
• Anchor state — detected when the vessel is stationary with engines off

All data is sent over HTTPS to the FomoFleet API using your Tracker ID for authentication.

Installation via npm (manual)

If you prefer to install outside the Signal K Appstore:

cd ~/.signalk
npm install signalk-fomofleet

Then restart your Signal K server and configure the plugin as described in Step 6 above.

Compatibility

| Requirement | Version | |---|---| | Signal K server | 1.x / 2.x | | Node.js | 14 or later |

Support

• Help Center: fomofleet.com/Help
• Quick Start Guide: fomofleet.com/Help/QuickStart
• Bug reports: GitHub Issues
• Email: [email protected]

License

ISC © FomoFleet