tl-openmeter-local-dev

Set up and troubleshoot an OpenMeter local development environment with Docker and ngrok.

Updated Feb 14, 2026
One-click install
npx skills add https://github.com/toddlevy/tl-agent-skills --skill tl-openmeter-local-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tl-openmeter-local-dev
Source: https://github.com/toddlevy/tl-agent-skills/tree/main/skills/tl-openmeter-local-dev
Command: npx skills add https://github.com/toddlevy/tl-agent-skills --skill tl-openmeter-local-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Set up and troubleshoot a full OpenMeter local development environment.

Core Features & Use Cases

  • Local Docker-based OpenMeter setup with self-hosted vs cloud parity
  • Stripe App integration and webhook orchestration using ngrok
  • Catalog synchronization, health checks, and environment-aware debugging

Quick Start

Use the OpenMeter local dev skill to set up the full local stack, including Docker, Stripe app, ngrok, and webhook verification.

Frequently Asked Questions about tl-openmeter-local-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a local OpenMeter environment with Docker?

OpenMeter local setup uses Docker orchestration to spin up the full stack and applies environment configuration files to establish service connectivity, ensuring your local environment mirrors staging and production behavior.

How do I integrate the Stripe app and configure webhooks for local development?

You can integrate the Stripe app and configure webhooks for local development by using ngrok to expose your local server. This allows webhook orchestration to route Stripe events directly to your local OpenMeter instance.

What is catalog synchronization in OpenMeter and when do I need it?

Catalog synchronization in OpenMeter aligns your local metering configurations with staging and production environments. You need it when testing catalog changes locally to ensure consistent behavior across your deployment pipeline.

Can I use ngrok to troubleshoot OpenMeter webhook connectivity locally?

Yes, you can use ngrok to troubleshoot OpenMeter webhook connectivity locally. The environment implements script-driven health checks that verify webhook orchestration and app connectivity through the ngrok tunnel.

Why are my OpenMeter local Docker services failing health checks?

OpenMeter local Docker services may fail health checks due to incorrect environment configuration files or broken webhook connectivity. Troubleshooting involves verifying Docker orchestration settings and running script-driven health checks to isolate the failing service.