> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreflux.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Routes Overview
> Add, configure, and monitor Routes in the Coreflux HUB—view status, edit configuration, and inspect route logs
## Why Use the Routes Section?
You need to manage Routes from the browser—add new routes, edit configuration, check connection status, and troubleshoot with logs. The Routes section of the Coreflux HUB lets you configure routes with a visual editor or LoT code, view connected and disconnected routes, and inspect route-specific logs.
## When to Use It
* **Adding routes** — Create routes from templates (PostgreSQL, MongoDB, Modbus, etc.) or write LoT code directly
* **Configuring routes** — Edit configuration, events, mappings, and tags in Visual or LoT mode
* **Monitoring** — See which routes are connected and which are not, and view real-time status metrics
* **Troubleshooting** — View route logs, filter by level, and export for analysis
***
## Routes Tools
Edit routes, view status (connected/not connected), and delete routes.
View real-time status metrics and logs filtered by route, export as JSON/CSV/LOG.
***
## Route List and Status
The Routes Manager displays all defined routes as cards. Each route card shows the route name, type (e.g., `SIEMENS_S7`), and a **status indicator** dot in the top-right corner. The dot color tells you the current connection state at a glance:
| Color | Status |
| ---------- | -------------- |
| **Green** | Connected |
| **Red** | Not connected |
| **Gray** | Unknown status |
| **Yellow** | Reconnecting |
Use the controls at the top to **sort** routes by name and **filter** by type. The **Delete All** button removes all routes, and the **Add a route +** button opens the route creation options.
## Route Card Actions
Click on a route card to open its context menu with three options:
| Action | Description |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Configuration** | Opens the [Routes Configuration](/coreflux-hub/routes/configuration) panel to edit settings, events, mappings, and tags |
| **Monitor** | Opens the [Routes Monitoring](/coreflux-hub/routes/monitoring) window with a **Status** tab (connection, health, messages, errors) and a **Logs** tab (real-time route logs) |
| **Documentation** | Opens the Coreflux documentation for the route type directly inside the HUB |
### Route Documentation
The Documentation option opens the Coreflux docs page for the route type in an embedded viewer inside the HUB. This gives you quick access to syntax reference, configuration parameters, and examples without leaving the interface.
***
## Adding a Route
Click **Add a route +** in the Routes Manager. The **Create a New Route** modal appears with two options:
* **Start from Scratch** — Opens the LoT code editor where you write your route definition from scratch
* **Start from Template** — Opens the template list where you pick a route type and configure it visually
| Method | Best For |
| ----------------------- | ------------------------------------------------------------------- |
| **Start from Scratch** | Custom routes, full control over syntax, copying from documentation |
| **Start from Template** | Quick setup for common route types with a visual configuration form |
### Start from Scratch
Select **Start from Scratch** to open the **Create Route with Code Editor** modal. Write your route definition in LoT language and click **Create Route** to deploy.
Example:
```lot theme={null}
DEFINE ROUTE MyPostgres WITH TYPE POSTGRESQL
ADD SQL_CONFIG
WITH SERVER "localhost"
WITH PORT '5432'
WITH DATABASE "iot_data"
WITH USERNAME "admin"
WITH PASSWORD "your_password"
ADD EVENT StoreSensor
WITH SOURCE_TOPIC "sensors/#"
WITH QUERY "INSERT INTO readings (topic, value) VALUES ('{topic}', '{value.json}')"
```
### Start from Template
Select **Start from Template** to open the templates list. Choose a route type to configure it visually.
1. Select **Start from Template** from the Create a New Route modal.
2. The **Templates** list opens with available route types.
3. Use **Search by type...** to filter (e.g., "PostgreSQL", "Modbus").
4. Select a template. The route creation view opens with a configuration form.
When you select a template, a configuration tab opens with **Visual Mode** and **LoT Mode**. Visual Mode displays all configuration fields and events as a form. LoT Mode shows the raw LoT code.
* **Configuration** — Fill in the connection fields (server, port, database, username, password). Required fields are marked with a badge. Use **+ Add Field** to include optional parameters.
* **Events** — Define events for the route (e.g., queries triggered by MQTT messages).
* **LoT Mode** — Switch to LoT Mode to view or edit the generated LoT code directly.
5. Fill in the configuration fields and add events as needed.
6. Click **Create Route** to deploy. Click **Cancel** to discard.
Templates are available for all supported route types. See the [Routes Overview](/lot-language/routes/overview) for the full list of available types and their documentation.
***
## Next Steps
Edit routes with Visual or LoT mode.
Learn route syntax and available route types.