> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://docs.moormesh.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Onboarding with Moormesh

# Getting Started: The MoorMesh Onboarding Wizard

**Article type:** How-to guide  
**Audience:** New MoorMesh members who have received an approval email from their club or harbour  
**Last updated:** 28 March 2026



## Overview

Once your club or harbour administrator has approved your membership application, you will receive an email containing a personal onboarding link. Clicking that link takes you to the MoorMesh setup wizard at `/onboard`. The wizard walks you through every step required to get your boat under active security monitoring: linking your Telegram account for instant alerts, registering your boat and its mooring position, connecting your Reolink 4G camera, and firing a live test alert to confirm everything is working.

The wizard is designed to be completed in a single sitting and takes approximately five to ten minutes. Every step can be skipped and completed later from your account settings if you need more time.



## Before You Begin

You will need the following before starting the wizard:

| Requirement | Notes |
| ---- |
| MoorMesh account | Created automatically when you sign in via Google or another supported provider |
| Approval email | Sent by your club/harbour admin; contains your personal onboarding link |
| Telegram app | Free to download; required for real-time alert notifications |
| Reolink 4G camera | Supported models send motion alerts via email; SMTP credentials are generated during setup |
| Boat name | Pre-filled from your registration form, but you can change it |



## Step 1 — Welcome

The first screen introduces MoorMesh and explains how the system works. A short summary is shown:

> Your Reolink 4G camera detects motion on your boat → MoorMesh sends you a private Telegram message → If you do not cancel within the grace period, your club and harbour are notified.

An intro video will appear on this screen in a future release. When you are ready, tap **Get started** to proceed.



## Step 2 — Telegram: Do You Have It Installed?

MoorMesh uses Telegram to deliver private, real-time alert notifications directly to your phone. This step checks whether you already have the app installed.

**If you already have Telegram**, select "Yes, I have Telegram" and the wizard skips the installation step, taking you directly to the account-linking screen.

**If you do not have Telegram**, select "I need to install it" and the wizard will show you download links for your platform (see Step 3).

> **Why Telegram?** Telegram delivers messages instantly and reliably even when your phone is in low-signal areas. It also allows MoorMesh to send you interactive messages — for example, a Cancel button you can tap to dismiss a false alarm before your club is notified.



## Step 3 — Install Telegram *(skipped if already installed)*

If you selected that you need to install Telegram, this step presents download links for your current device. The wizard automatically detects your platform and highlights the recommended option:

| Platform | Download |
| ---- |
| iPhone / iPad | App Store |
| Android | Google Play |
| macOS | [macos.telegram.org](https://macos.telegram.org/) |
| Windows | [desktop.telegram.org](https://desktop.telegram.org/) |

Once Telegram is installed, tap **I've installed Telegram — link my account** to continue.



## Step 4 — Link Your Telegram Account

This step connects your MoorMesh account to your personal Telegram identity so the bot can send you private messages.

**How to link in three steps:**

1. Tap the **Open Telegram to Link Account** button. MoorMesh generates a unique, time-limited deep link and opens it in Telegram.
2. In Telegram, tap the **Start** button at the bottom of the conversation with the MoorMesh bot.
3. Return to the MoorMesh wizard — the page detects the link automatically and advances to the next step. No manual confirmation is needed.

The page polls for confirmation every three seconds. Once the link is detected, a green "Telegram linked!" confirmation is shown and the wizard advances automatically.

**If the link expires** or you encounter a problem, tap **Generate a new link** to create a fresh one.

**Skipping this step:** If you prefer to use email alerts only, tap *Skip for now — use email alerts only*. You can link Telegram at any time from your account settings. Note that without Telegram, you will not receive the interactive Cancel button — your only alert channel will be email.



## Step 5 — Register Your Boat

This step creates your boat record in MoorMesh and optionally assigns it to a mooring position so it appears correctly on the Fleet Map.

### Boat Name

The name field is pre-filled with the boat name you entered on your original registration form. You can edit it if needed. A small note reading *"Pre-filled from your registration"* confirms the pre-population.

### Mooring / Location

Setting a location is optional but recommended — it places your boat as a pinned marker on the Fleet Map, making it easier for harbour staff and fellow members to identify it.

Two methods are available, selectable via the **Select Mooring** and **Click Map** tabs:

| Method | When to use |
| ---- |
| **Select Mooring** | Your club has pre-registered moorings. Choose your mooring from the dropdown; the map pans to it automatically and shows a marker. |
| **Click Map** | Your mooring is not in the list, or you want to pin an exact GPS position. Switch to this tab, then click anywhere on the map to drop a pin, or type latitude and longitude directly into the coordinate fields. |

If your club has not yet registered any moorings, the Select Mooring tab will show a message prompting you to use the Click Map method instead.

Tap **Register Boat** to save. If you already have a boat registered in MoorMesh, this step will detect it and offer to continue directly to the camera step.

**Skipping this step:** Tap *Skip — I'll add my boat later* to proceed without registering a boat. You can add boats at any time from **My Boats → Add Boat**.



## Step 6 — Add Your Camera

This step registers your Reolink 4G camera with MoorMesh and generates the unique SMTP credentials you will enter into the camera's email settings.

### What happens when you register a camera

MoorMesh creates a dedicated SMTP mailbox for your camera. When the camera detects motion, it sends an alert email to that mailbox. MoorMesh receives the email, processes the alert, applies the false-alarm grace period, and notifies you (and, if unacknowledged, your club and harbour).

### How to register

1. Optionally enter a **camera label** (e.g. *Bow camera*, *Stern camera*) to identify it if you have multiple cameras on the same boat.
2. Tap **Register Camera**.
3. MoorMesh displays your unique SMTP credentials: server address, port, username, and password.
4. Enter these credentials into your Reolink camera's **Email Settings** page (found under the camera's app or web interface under System → Email).

**Skipping this step:** Tap *Skip — I'll add my camera later*. You can add cameras at any time from the boat's detail page under **My Boats**.

More information on completing this process can be [found here](https://docs.moormesh.com/en/article/setting-up-reolink-app-for-moormesh-alerts-1yq78or/). 

## Step 7 — Test Your Alert

This step fires a live test alert so you can experience the full notification flow before relying on it in a real situation. **This is a personal test only — your club and harbour are not notified.**

### How the test works

1. Tap **Send Test Alert**. MoorMesh immediately triggers a simulated motion event on your boat.
2. You will receive a notification via **email** and, if Telegram is linked, via **Telegram** as well.
3. A 90-second countdown timer appears on screen. This is the **grace period** — the window during which you can cancel the alert before it escalates to your club and harbour.
4. Tap **Cancel Alert — it was me!** to dismiss the test. A confirmation message confirms the cancellation.

> **This is the most important feature to understand.** In real life, if your camera fires a false alarm (e.g. you forget to disable the alarm when you get onboard), you have the same grace period to cancel it. Cancelling within the window means your club and harbour receive no notification at all.

If the grace period expires without cancellation, the alert would escalate — but since this is a test, no escalation actually occurs.

**Skipping this step:** Tap *Skip test alert* to proceed without testing.



## Step 8 — Done

The final screen shows a summary of everything you have set up:

| Item | Status shown |
| ---- |
| Telegram | Linked (green tick) or Not linked (amber warning) |
| Boat | Name of registered boat, or "No boat registered yet" |
| Camera | Registered (green tick) or "No camera registered yet" |

Any items not yet completed show an amber warning with a prompt to finish them later. Tap **Go to My Boats** to enter the main MoorMesh dashboard.



## Frequently Asked Questions

**Can I redo the onboarding wizard?**  
The wizard is a one-time flow tied to your approval link. However, every action in the wizard — adding a boat, adding a camera, linking Telegram — can be performed independently at any time from your account and boat settings pages.

**What if my boat name was wrong on the registration form?**  
The boat name field is pre-filled but fully editable. Simply overwrite it with the correct name before tapping Register Boat.

**My mooring is not in the dropdown. What should I do?**  
Switch to the **Click Map** tab and click your mooring position on the map, or type the GPS coordinates directly. You can also ask your club administrator to add the mooring to the system, after which it will appear in the dropdown for all members.

**I skipped Telegram. Can I add it later?**  
Yes. Go to your account settings (click your name in the top-right corner of any page) and follow the Telegram link instructions from there.

**I received a test alert email but not a Telegram message.**  
Confirm that you completed Step 4 (Telegram linking) and that you tapped **Start** in the Telegram conversation with the MoorMesh bot. If the bot conversation shows no messages, the link was not completed — return to account settings and re-link.

**How do I trigger or cancel a real alarm?**  
In normal operation, your camera triggers alerts automatically when it detects motion. If you board your own boat and want to prevent a false alarm, you can either tap **Cancel Alert** in the Telegram message the bot sends you, or open the boat's detail page in MoorMesh and tap **Cancel Alert** there. You can also enable **Owner Onboard** mode from the boat detail page, which suppresses all alerts while you are on board.