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 opensws://<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
| Route | Gateway in the app | Protocol | Port | When it makes sense |
|---|---|---|---|---|
| Signal K directly | Signal K (JSON) | Signal K (WebSocket) | 3000 | The normal case. The app reads the Signal K data itself. |
| The server's NMEA 0183 output | Signal K | TCP | 10110 | If 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.1with your server's IP address or hostname, for example192.168.1.50orsignalk.local. The port stays3000unless you've changed it on the server. Names ending in.localonly 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
| Path | Value in the logbook |
|---|---|
navigation.position | Position |
navigation.gnss.horizontalDilution | GPS accuracy |
navigation.speedOverGround | Speed Over Ground |
navigation.courseOverGroundTrue | Course Over Ground |
navigation.headingTrue | True heading |
navigation.attitude | Heel and trim |
navigation.log, navigation.trip.log | Trip log (total, trip) |
Wind, water, weather
| Path | Value in the logbook |
|---|---|
environment.wind.directionTrue | True wind direction |
environment.wind.speedOverGround | True wind speed |
environment.wind.angleApparent | Apparent wind angle |
environment.wind.speedApparent | Apparent wind speed |
environment.depth.belowTransducer, .belowSurface, .belowKeel | Water depth |
environment.water.temperature | Water temperature |
environment.outside.temperature | Air temperature |
environment.outside.pressure | Barometric pressure |
environment.current | Current (set, drift) |
Engine, tanks, batteries
| Path | Value in the logbook |
|---|---|
propulsion.<id>.revolutions | Engine RPM |
propulsion.<id>.runTime | Engine hours |
tanks.fuel.<id>.currentLevel, .currentVolume | Fuel tank |
tanks.freshWater.<id>.currentLevel, .currentVolume | Fresh water tank |
tanks.wasteWater.<id>.currentLevel, .currentVolume | Gray water tank |
electrical.batteries.<id>.voltage | Battery voltage |
electrical.batteries.<id>.capacity.stateOfCharge | State 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 path | Number in the app |
|---|---|
0, starboard, stb, main | 1 |
1, port | 2 |
2, center, centre | 3 |
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 see | Cause | Fix |
|---|---|---|
| “… is unreachable” | Wrong Wi-Fi network or wrong address | Check 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 HTTPS | Check the port. The app needs an unencrypted connection (ws://). |
| “No data is arriving on port …” | The server requires a login or has no data itself | Allow read access without a login (see below). Check in the server's Data Browser whether values are coming in. |
| Connected, but individual values are missing | The path doesn't exist on the server, or the identifier isn't recognized | Look up the exact path in the Data Browser and compare it with the tables above. |
| Values are there, but not in the entry | The Signal K source isn't in first place | Adjust 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
- signalk.org: project site with an introduction and installation guides
- Signal K specification: all paths and units in detail
- Signal K server on GitHub: the server itself, with notes on security and access rights
- The difference between NMEA 0183, NMEA 2000, and Signal K
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.