Help & FAQ

Get more from Passagebook.

Answers to the essentials, from your first imported track to a complete Signal K setup.

Ask a support question

Passagebook essentials

What is Passagebook?

Passagebook is a logbook and trip report app for Mac, iPad and iPhone. Record a passage on iPhone, keep a live Log with your boat’s Signal K instruments, or import GPX tracks, then turn the route, stops and photos into a report. Export it as PDF, publish it on passagebook.app or share it through iCloud. Sailing, Boating, Road and Hike trips each get their own maps, wording and statistics.

Does Passagebook replace my chart plotter?

No. Passagebook is a logbook, not a navigation app: it does not plan routes or replace your charts. Use it alongside your plotter or chart app to keep the record of each passage, with its track, instruments, Log entries and photos.

Which devices can I use?

Passagebook requires macOS 13.7 or later, or iPadOS/iOS 16.4 or later. Mac, iPad and iPhone can all create and edit trips, keep the Log, and publish reports. iPhone adds passage recording with the screen locked. Manual track drawing, Retrace from photos and Online Logbook website export need Mac or iPad; HTML report export needs Mac.

Is there an Android version?

No. Passagebook runs on Mac, iPad and iPhone. Published reports and the Online Logbook open in any web browser, including on Android and Windows.

Can I use Passagebook without Signal K?

Yes. Record a passage with iPhone, import GPX files from any plotter, app or tracker, or draw a missing route on Mac or iPad. Without Signal K, the Log uses this device’s location for position, speed and course over ground. Wind, heading, depth and speed-through-water gauges need Signal K.

How do I create my first report?
  1. Create a trip with the + button and choose Sailing, Boating, Road, or Hike. On iPhone, the new-trip guide takes you through the next steps.
  2. In Setup, import a GPX track, Signal K logbook data, or supported photos.
  3. Refresh the Tracks card to build stops and legs.
  4. Import and curate photos, then open Report to review the result.
  5. Publish a Sailing report on passagebook.app, export HTML or PDF on Mac, or export and share a PDF on iPad and iPhone.
What does the trip type change?

Sailing, Boating, Road, and Hike profiles adapt labels, icons, default units, analytics, and report wording. Changing the type does not replace or rewrite the trip's underlying data.

How much does Passagebook cost?

Passagebook is free to download. Viewing existing trips, exporting reports, sharing and the Online Logbook remain free, as does keeping the Log of an existing trip you can edit. One permanent Creation Unlock enables creation and editing on Mac, iPad and iPhone, including new trips and track and photo import. New users get a free seven-day trial.

What does publishing a report cost?

Publishing full Sailing reports on passagebook.app needs hosted access. Creation Unlock includes one 30-day hosted trial, which starts with your first successful publication. Monthly and annual auto-renewing subscriptions continue hosting; they do not unlock local editing. After hosted access ends, existing report links stay readable for 30 days. Your local trips, exports and the free Online Logbook remain available.

The live Log

How do I start a live logbook?

On iPhone, tap Start Passage in the trip list, name the trip and choose Sailing or Boating, or tap + and choose Ongoing in the guide. On Mac or iPad, create a Sailing or Boating trip and turn on Ongoing Trip in Setup. Open Log to follow the vessel and instruments. Creating the trip requires Creation Unlock; owners and crew with write access can keep an existing trip’s Log for free.

How does iPhone record a passage?

Tap Start Passage. Passagebook records the route in the background and with the screen locked, sampling a position about every two minutes; reception and iOS scheduling can delay fixes. The Lock Screen and Dynamic Island show distance, elapsed time and speed. Tap End Passage to save it as a leg with its arrival stop and review its map, distance and duration. GPS stays off between passages. If iOS closes the app, reopen it to resume; the interruption appears as a gap in the track.

Do the gauges need Signal K?

Yes. Wind, heading, depth and speed-through-water instruments use the data available from your boat’s Signal K server. Without that data, this device’s location supplies position, speed and course over ground. On iPhone and iPad, recording continues in the background and with the screen locked; on Mac, Passagebook must stay in the foreground. Missing or stale instruments are not shown as zero.

Does Passagebook work offline at sea?

Yes. iPhone records passages from GPS without a mobile signal, Log entries save offline and sync through iCloud when a network is available, and Passagebook reaches your Signal K server over the boat’s own network. Publishing, iCloud sync and the interactive map in a published report need an internet connection.

How do I add notes and revisit a passage?

Choose Log Now to save the time, position and current instruments, then add a remark. Entries save offline and sync through iCloud when a network is available. After ending the trip, select an entry in Log to see its position on the saved track. Live gauges are not shown during playback.

Set up Signal K →

Tracks, stops, and photos

Which track sources are supported?

Import standard GPX files on Mac, iPad or iPhone, or record a passage with iPhone. Sailing and Boating trips can also import Signal K logs or use a track drawn manually on Mac or iPad. Road trips can retrace a route from geotagged photos when no GPX track is available.

How are stops and legs created?

After importing a track, use the refresh button in the Tracks card. Passagebook segments the timeline into travel legs and stops using the rules for the selected trip type. You can then rename stops, adjust assignments, and review each segment on the map.

How are photos placed on the map?

Passagebook matches each photo's EXIF capture time to the GPS timeline, then groups it with the relevant stop or leg. Photos can be imported from files, the Photos library, an album, or automatically from the trip time window. You can manually reassign any photo that needs correction.

Where can I export a report?

Mac exports self-contained HTML bundles and paginated A4 PDFs. iPhone and iPad can preview, export and share PDF reports. Every device can also publish a Sailing report on passagebook.app or create Post and Story images.

iCloud sync, sharing and publishing

Where is my trip data stored?

Structured trip data syncs through your private iCloud account, while imported project files use iCloud Drive where applicable. Only what you choose to publish appears on passagebook.app: the privacy-filtered Online Logbook, and the photos, captions and notes you select for a published report.

How do I see the same trips on every device?

Sign in to the same Apple Account on each device, enable iCloud Drive for Passagebook, and leave Cloud Sync enabled for the active library. Sync can continue in the background after the trip list first appears.

Can I export my data, and who owns it?

Your trips stay yours. Your library lives on your devices and in your private iCloud; Passagebook has no account to create and keeps no copy of it. Only what you choose to publish leaves iCloud: your Online Logbook is served from Apple’s public iCloud database, and a published report’s selected photos, captions and notes are hosted on passagebook.app until you withdraw them.

  • On Mac, back up the whole library with Library > Export Library Backup… and save individual legs with Export GPX.
  • Export reports as PDF on any device, or as self-contained HTML on Mac.
  • Export the Online Logbook website on Mac or iPad.
  • With Signal K, the plugin also keeps its daily YAML log files on your server.
How do I share a passage with family and friends?
  • Publish a Sailing report on passagebook.app and send its link.
  • Publish your free Online Logbook, one page for all your Sailing trips. See an example logbook.
  • Create Post and Story images with your route, a key photo and the trip’s statistics.
  • Choose Collaborate… on iPhone, or Invite… on Mac and iPad, to create a read-only iCloud link. Recipients can view the report, map, photos, stops and legs in Passagebook, but cannot edit the trip.
What is the Online Logbook?

A free public page on passagebook.app for all your owned Sailing trips, with routes, stops, dates, wind and summary statistics, and links to your published reports. Photos, notes, crew details, raw log text and trips received from others stay private. Visitors can switch between English and French. Publish, update or unpublish it from the globe in the trip list on Mac, iPad or iPhone. To use your own domain, export the website on Mac or iPad and add a free CARTO map key.

Sailing & boating

Set up Signal K

Signal K import is available for Sailing and Boating trips. Complete these steps on the computer or marine hub running your Signal K server.

What do I need to run Signal K?

A Signal K server on your boat’s network. Signal K Server is free, open-source software that often runs on a small computer such as a Raspberry Pi. On a Victron Cerbo GX, install the Venus OS Large image, which includes Signal K Server; the normal Venus OS image does not. The in-app Setup Guide covers the Cerbo GX steps.

Which Signal K plugin does Passagebook use?

Passagebook reads its trips from signalk-cruisereport, a fork of the open-source Signal K Logbook plugin, with @meri-imperiumi/signalk-autostate detecting when the boat is sailing, motoring or anchored. Install both as described below. If you used the original Signal K Logbook plugin, import the GPX files it exports; their wind and log entries come in with the track.

Prepare the server

Confirm that Signal K Server is running and that your Mac, iPad or iPhone can reach it over the same network. The standard server port is 3000.

Install the plugins

From a browser, open the Signal K dashboard (port 3000) as an administrator. In Appstore → Available, install signalk-cruisereport and its vessel-state companion @meri-imperiumi/signalk-autostate. The server needs an internet connection.

Restart Signal K, then open Server → Plugin Config and confirm that Cruise Report and signalk-autostate are enabled.

If you prefer a terminal, install both on the Signal K server host instead:

npm install -g signalk-cruisereport
npm install -g @meri-imperiumi/signalk-autostate

Cruise Report package · Auto-state package

Configure logging

In the Signal K Admin UI, review both plugin configurations. Auto-state supplies navigation.state, allowing Cruise Report to detect anchored, sailing, and motoring changes. Cruise Report records start/end changes and periodic underway entries.

  • Set the Cruise Report log timezone to the vessel's local timezone.
  • Keep the default 30-minute heartbeat or choose an interval appropriate for your reports.
  • Confirm that Signal K receives position and navigation data before expecting log entries.

Connect Passagebook

  1. Open Passagebook Settings on Mac, iPad or iPhone. Setup Guide there opens the full guide, offline on iPhone and iPad.
  2. Open Charts & Instruments.
  3. Enter the Signal K hostname or IP address and port, normally 3000.
  4. Select Test Connection, then save the settings.

The device must be able to reach the Signal K host. Do not enter localhost on an iPad or iPhone unless Signal K is running on that same device.

Import or generate trips

For one trip, choose Import Signal K in the Tracks card, fetch available dates, and import the dates you need. To create multiple trips automatically, use the wand in the sidebar, review the detected trips, and select Generate Selected.

Automatic generation can also import Photos-library images captured within each trip's configured time window.

Signal K troubleshooting

Test Connection cannot find the server
  • Open http://SERVER-IP:3000 from the same Mac, iPad or iPhone to confirm network access.
  • Use the server's LAN hostname or IP address, not localhost, when Signal K runs on another device.
  • Confirm that the Cruise Report plugin is enabled, then restart Signal K.
  • Check firewalls, guest Wi-Fi isolation, and VLAN rules between the Apple device and Signal K server.
The server connects, but no dates appear

Open the Cruise Report plugin in Signal K and confirm that it contains logbook days. Check that position data is present and that navigation.state is being produced by signalk-autostate. A day is listed only after at least one entry has been written.

Trip times or dates are wrong

Set the Signal K host clock and the Cruise Report plugin's log timezone correctly, then restart the plugin. Daily files and trip grouping use that configured timezone.