Knowledge · Guide

Connect Signal K to the Logbook app

The Logbook app connects to your Signal K server via WebSocket and puts position, wind, depth, engine, tanks, and batteries into your log entries. All you need is the server's address and the port, usually 3000.

Updated: November 2026

In short

What the app reads
Position, heading, wind, depth, temperatures, barometric pressure, engine, tanks, batteries, heel, and trim for your own boat.
Address and port
Your server's IP address or hostname, port 3000, protocol “Signal K (WebSocket).” The app opens ws://<server>:3000/signalk/v1/stream?subscribe=self.
What doesn't work
Signing in with a username or token, and encrypted connections (wss://). The server has to allow read access without a login.
Get started
Settings › Data sources › NMEA connection settings › pick the “Signal K (JSON)” gateway.

What is Signal K?

Signal K is a free, open data format for boats. It's developed as an open-source project, and the specification and the Signal K server are freely available. A Signal K server, usually on a Raspberry Pi or inside a device like the Victron Cerbo GX, collects the data from NMEA 0183, NMEA 2000, and other sources and makes it available on the network in one consistent format. Every value has a readable name, for example environment.depth.belowTransducer, and a fixed unit.
What that means for you: if you have a Signal K server on board, the app doesn't need an additional gateway.

Two ways to reach the Signal K server

RouteGateway in the appProtocolPortWhen it makes sense
Signal K directlySignal K (JSON)Signal K (WebSocket)3000The normal case. The app reads the Signal K data itself.
The server's NMEA 0183 outputSignal KTCP10110If your server is set up to output NMEA 0183.
This guide covers the direct route.

Setup

  • Connect your phone or tablet to the Wi-Fi network the Signal K server is on.
  • Open Settings › Data sources › NMEA connection settings and tap the first row under “Connection.”
  • Pick Signal K (JSON).
  • Replace the preset address 192.168.1.1 with your server's IP address or hostname, for example 192.168.1.50 or signalk.local. The port stays 3000 unless you've changed it on the server. Names ending in .local only work if the server announces itself on the network via mDNS (Zeroconf, usually already active on a Raspberry Pi). If the name doesn't work, use the IP address.
  • Turn on NMEA Connection. The status shows “Signal K,” and the live values appear under Received Data.
  • Open Settings › Data sources › Define data sources and drag the Signal K source to first place for every value you want. Only then do the values end up in your entries.
Technically, the app opens the address ws://<server>:<port>/signalk/v1/stream?subscribe=self and reads the delta messages for your own boat. It ignores data from other vessels, such as AIS targets.

Supported Signal K paths

The app converts Signal K's SI units itself: radians to degrees, m/s to knots, kelvin to °C, pascals to hPa.

Navigation

PathValue in the logbook
navigation.positionPosition
navigation.gnss.horizontalDilutionGPS accuracy
navigation.speedOverGroundSpeed Over Ground
navigation.courseOverGroundTrueCourse Over Ground
navigation.headingTrueTrue heading
navigation.attitudeHeel and trim
navigation.log, navigation.trip.logTrip log (total, trip)

Wind, water, weather

PathValue in the logbook
environment.wind.directionTrueTrue wind direction
environment.wind.speedOverGroundTrue wind speed
environment.wind.angleApparentApparent wind angle
environment.wind.speedApparentApparent wind speed
environment.depth.belowTransducer, .belowSurface, .belowKeelWater depth
environment.water.temperatureWater temperature
environment.outside.temperatureAir temperature
environment.outside.pressureBarometric pressure
environment.currentCurrent (set, drift)

Engine, tanks, batteries

PathValue in the logbook
propulsion.<id>.revolutionsEngine RPM
propulsion.<id>.runTimeEngine hours
tanks.fuel.<id>.currentLevel, .currentVolumeFuel tank
tanks.freshWater.<id>.currentLevel, .currentVolumeFresh water tank
tanks.wasteWater.<id>.currentLevel, .currentVolumeGray water tank
electrical.batteries.<id>.voltageBattery voltage
electrical.batteries.<id>.capacity.stateOfChargeState of charge

How the app numbers engines, tanks, and batteries

In Signal K, every engine, tank, and battery has an identifier (<id>). The app maps them like this:
Identifier in the pathNumber in the app
0, starboard, stb, main1
1, port2
2, center, centre3
The app doesn't currently recognize other identifiers, such as house or starter. Rename the identifier on the server or get in touch with me and I'll add it.

Water depth: which path?

Signal K has three depths: below the transducer, below the surface, and below the keel. The app shows all three as separate sources. In the data source order, pick the one you want in your logbook.
The offset from the NMEA settings is added to every depth. If you use belowSurface, where your server has already factored in the transducer offset, set the offset in the app to 0.

Troubleshooting

What you seeCauseFix
“… is unreachable”Wrong Wi-Fi network or wrong addressCheck whether you can open the Signal K interface in a browser at http://<server>:3000.
“… is reachable, but no service is responding on port …”Wrong port, or the server only runs over HTTPSCheck the port. The app needs an unencrypted connection (ws://).
“No data is arriving on port …”The server requires a login or has no data itselfAllow read access without a login (see below). Check in the server's Data Browser whether values are coming in.
Connected, but individual values are missingThe path doesn't exist on the server, or the identifier isn't recognizedLook up the exact path in the Data Browser and compare it with the tables above.
Values are there, but not in the entryThe Signal K source isn't in first placeAdjust the data source order.
Signing in to the server: The app can't sign in with a username or token. I've tested with a server that has security turned off, and that works reliably. If you have security turned on, allow read-only access without a login on the server (“Allow Readonly Access”). I haven't tried that myself yet. Whether it works for you or not, I'd appreciate a quick note.

What doesn't work

  • Signing in with a username, password, or token.
  • Encrypted connections (wss:// or HTTPS).
  • Finding the server on the network automatically. You enter the address yourself.
  • Writing data back to the Signal K server. The app only reads.
  • AIS targets and other vessels.
Need any of that? Get in touch with me. I'll do my best to find a solution.

Further reading

Frequently asked questions

Does the Logbook app support Signal K?

Yes. Starting with version 2.92 (iOS) and 1.36 (Android), the app connects to a Signal K server via WebSocket and puts the values into your log entries. The feature is free.

Which port does Signal K use?

Out of the box, the Signal K server uses port 3000 for the web interface and the WebSocket stream. The server's NMEA 0183 output usually runs on TCP port 10110.

Do I still need an NMEA gateway with Signal K?

No. The Signal K server is the gateway. It has to be connected to your NMEA 0183 or NMEA 2000 network itself, for example through a USB adapter.

Does it work with a Victron Cerbo GX or Venus OS?

Yes, if the Signal K server is enabled there and readable on Wi-Fi on port 3000 without a login. If you still run into trouble, drop me a line. I'll get it working.

Can the app sign in to the Signal K server?

No. The app needs read access without a login over an unencrypted WebSocket connection (ws://).

Which is better: Signal K or NMEA directly?

If you already have a Signal K server, go with Signal K. You get all of your boat's sources over one connection. If you don't have one, an NMEA-to-Wi-Fi gateway is the easier route.