---
title: "Historian | Examples | N3uron KB V1.22"
slug: "historian-examples"
description: "Historian is a N3uron module designed to provide the communication platform with a high-performance time-series storage system based on either MongoDB or TimescaleDB"
updated: 2026-05-03T18:00:08Z
published: 2026-05-03T18:00:08Z
canonical: "docs.n3uron.com/historian-examples"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.n3uron.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Examples

## Connecting to MongoDB Atlas

The following steps will help you connect your Historian instance to an **Atlas Cluster** in a matter of minutes.

### Prerequisites

- An Atlas account.
- An organization and project with an account's user who has permission to create clusters.
- An active cluster created in this account.
- An IP address added to your IP access list.
- A Database user on your cluster.

Take a look at the [MongoDB Documentation](https://www.mongodb.com/docs/atlas/) for more information.

### Getting the Connection String from Atlas

You'll need to get your cluster's connection string from Atlas to connect your **N3uron's Historian instance** to the cluster using the **Node.js** driver.

**Step 1:** Click on **Connect:**

- Click on **Clusters**in the top-left corner of Atlas.
- In the **Clusters** view, click on **Connect** for the database deployment to which you want to connect.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/connect%20to%20cluster.png)

**Step 2:** Click on **Connect your application→Drivers:** ![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/select%20drivers.png) **Step 3:** Select **Node.js** as the**Driver** and copy the connection string:

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/copy%20connection%20string.png)

### Configuring N3uron

**Step 1:** Select **External** as **Database type**and choose **MongoDB**.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/select%20external.png)

**Step 2:** Open the connection string helper.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/open%20connection%20string%20helper.png)

**Step 3:** Paste the connection string, replace the placeholders with the database user and password, then click **Apply**.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/fill%20username%20and%20password.png)

**Step 4:** Set the database name (e.g., n3-history) and then save the config.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/set%20database%20name.png)

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/save%20config%20and%20reload.png)

[Embedded content](https://www.youtube.com/embed/inUAn0QwMQo?&list=PLS63jGt25U8_0PeHswi6-TInnRkEgCLGY&index=10&wmode=opaque&rel=0)

## Connecting to TigerData

The following steps will help you connect your Historian instance to a **TigerData instance**.

### Prerequisites

- A [TigerData](https://www.tigerdata.com/)account.
- An active instance created in this account.
- An IP address added to your IP access list.

### Getting the connection details from TigerData

**Step 1:** In your Timescale project, navigate to **Overview**, then select **More details** in the **Service Info** section.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/get%20more%20details.png)

**Step 2:** Copy all the fields, as you will need them to configure the N3uron Historian.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/connection%20information.png)

### Configuring N3uron

**Step 1:** Select **External** as the database type.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/select%20external.png)

**Step 2:** Select **TimescaleDB** as the database engine.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/select%20timescaledb.png)

**Step 3:** Fill in the **Host**, **Port**, **Database Name**, and **Authentication**credentials using the information obtained previously from Timescale.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/configure%20connection.png)

**Step 4:** Enable the **TLS** section to use encrypted communications.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/enable%20tls.png)

**Step 5:** Save the changes and reload the module.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/save%20configuration.png)

## Connecting Historian to a self-managed MongoDB Replica Set

The following steps will help you connect the N3uron Historian to a self-managed MongoDB replica set deployment.

Example replica set with name **rs0** (refer to this [guide](https://www.mongodb.com/docs/manual/tutorial/deploy-replica-set/#overview) on deploying a replica set):

- [mongodb0.example.net:27017](//mongodb0.example.net:27017)
- [mongodb1.example.net:27017](//mongodb1.example.net:27017)
- [mongodb2.example.net:27017](//mongodb2.example.net:27017)

### Build the MongoDB connection string

This is the standard connection URI format. Refer to the [official documentation](https://www.mongodb.com/docs/manual/reference/connection-string/#standard-connection-string-format) for more details.

```plaintext
mongodb://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]
```

For the example above, the connection URL should be:

```plaintext
mongodb://username:password@mongodb0.example.net:27017,mongodb1.example.net:27017,mongodb2.example.net:27017/n3-history?replicaSet=rs0
```

### Configuring N3uron

**Step 1:**Go to the Historian module configuration and select **External**as the database type and **mongodb**as the protocol.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/image-1718192707355.png)

**Step 2:**Open the database connection helper, paste the connection URI created in the previous section, and click **Apply.**

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/image-1718192857721.png) ![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/image-1718192936730.png)

**Step 3:**Review the module settings and click **Save**to load the changes.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/image-1718193182491.png)