Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
79 changes: 79 additions & 0 deletions hosting/hosting_options/northflank.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
---
title: Langtrace on Northflank
sidebarTitle: Northflank
description: Running Langtrace Client on Northflank
---

## Requirements

1. [Northflank](https://app.northflank.com/signup) account

## Resources Created

| Resource Type | Comments |
| ------------------ | ----------------------------------- |
| Clickhouse Service | To store traces. |
| Postgres Addon | For login and dataset related info. |
| Langtrace Client | Langtrace app with frontend. |

## Setup

Setting up Langtrace on Northflank is now effortless. Just follow these simple steps:

### Step 1: Open the Northflank Template

[![Deploy on Northflank](/images/northflank/deploy-northflank-button.svg)](https://northflank.com/stacks/deploy-langtrace)

Clicking the button above will direct you to the Langtrace Northflank template deployment page.

![Northflank template](/images/northflank/langtrace-template-home.png)

### Step 2: Configure Authentication

When deploying the template, you’ll need to set up authentication for your Langtrace instance:

- Under the **Configuration** section, add the following environment variables:
- `ADMIN_EMAIL`: Your desired admin email
- `ADMIN_PASSWORD`: Your desired admin password
- For additional authentication methods (e.g. Google OAuth, Azure AD), refer to our [Authentication](/hosting/auth) guide to configure the necessary environment variables.

![Northflank inputs](/images/northflank/langtrace-template-config.png)

### Step 3: Deploy the Template

- Click **Deploy Stack** to start the deployment.
- Northflank will automatically create and configure the required services — Clickhouse, PostgreSQL, and Langtrace Client.
- Deployment typically takes about 2 minutes.

![Northflank Success](/images/northflank/langtrace-template-run.png)

### Step 4: Access Langtrace

- Once all services are running, open the **langtrace-client** service.
- Click the **Public URL** to access your Langtrace dashboard.

![Northflank URL](/images/northflank/langtrace-template-url.png)

Login using your previously configured admin credentials.
Then follow the [Quickstart Guide](/quickstart) to begin monitoring your LLM applications.

## Cleanup

To remove all resources:

1. Go to your **Northflank project dashboard**.
2. Click on **Project Settings → Danger Zone → Delete Project**.
3. Confirm deletion to remove all services, addons, and configurations.

## Troubleshooting

<AccordionGroup>
<Accordion title="Clickhouse service keeps restarting or crashing">
This usually occurs when the Clickhouse service runs out of memory.
You can increase the memory limit of the Clickhouse service from the **Resources** tab under its configuration.
</Accordion>

<Accordion title="Cannot access public URL">
If the public URL doesn’t open, ensure the **langtrace-client** service has an **HTTP port (3000)** exposed and marked as **Public** under **Networking settings**.
</Accordion>
</AccordionGroup>
3 changes: 3 additions & 0 deletions hosting/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -51,4 +51,7 @@ Langtrace supports multiple authentication methods, including Admin Password, Go
<Card title="Railway" icon="train" href="/hosting/hosting_options/railway">
Run Langtrace on Railway with a single click!
</Card>
<Card title="Northflank" icon="rocket" href="/hosting/hosting_options/northflank">
Run Langtrace on Northflank with a single click!
</Card>
</CardGroup>
79 changes: 79 additions & 0 deletions images/northflank/deploy-northflank-button.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/northflank/langtrace-template-config.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/northflank/langtrace-template-home.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/northflank/langtrace-template-run.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/northflank/langtrace-template-url.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 2 additions & 1 deletion mint.json
Original file line number Diff line number Diff line change
Expand Up @@ -227,7 +227,8 @@
"hosting/hosting_options/docker-compose",
"hosting/hosting_options/kubernetes",
"hosting/hosting_options/azure",
"hosting/hosting_options/railway"
"hosting/hosting_options/railway",
"hosting/hosting_options/northflank"
]
}
]
Expand Down