---
id: flask-cloudflared
version: "0.0.15"
license: unclear
license_treatment: permissive
maintenance: aging
---

# flask-cloudflared — Start a TryCloudflare Tunnel from your flask app.

License: permissive · Maintenance: aging · Downloads: 98.1K/mo

## What it is and what it does

flask-cloudflared wraps a Flask application with a decorator that automatically starts a Cloudflare TryCloudflare tunnel, making your local Flask app accessible via a public URL without manual tunnel setup. It depends on Flask, requests, and tqdm, and runs your app on port 5000 by default while starting a metrics page on a random port between 8100 and 9000. You can retrieve the tunnel URL programmatically and customize the port, metrics port, and tunnel domain through function arguments.

The package is designed for rapid prototyping, testing, and sharing—scenarios where you need a temporary public endpoint without infrastructure setup. It abstracts away the Cloudflare tunnel CLI, letting you manage tunneling directly from Python code. For persistent or custom domains, you can pass a tunnel ID or config path to use your own Cloudflare tunnel configuration.

Use it for:

- Quickly share a local Flask development server with teammates or external users without deploying to production.
- Test webhooks or third-party integrations that require a public URL pointing to your local machine.
- Demonstrate a Flask prototype or MVP to stakeholders without setting up hosting infrastructure.
- Debug issues in a live-like environment by exposing your local app to the internet temporarily.
- Set up automated testing or CI/CD workflows that need a public endpoint for callback validation.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Starts a Cloudflare TryCloudflare tunnel for a Flask app, exposing it to the internet with a public URL without manual configuration.

Yes, if you need rapid, zero-configuration tunneling for Flask development and testing. The low install friction, permissive license, and straightforward decorator API make it a practical choice for prototyping and temporary sharing. The aging maintenance status and small community (43 stars) mean it is not a long-term production solution, but it is reliable for its intended use case of quick local-to-public exposure.

## Install

pip install flask-cloudflared
uv add flask-cloudflared
poetry add flask-cloudflared

## Installing flask-cloudflared

Before you install: Low install friction with three lightweight runtime dependencies. Last commit was 2026-01-27 and the repository is active, though the project shows aging maintenance signals with infrequent updates.

License in practice: Licensed under Apache Software License (permissive), which allows commercial and private use with minimal restrictions.

Quickstart:

pip install flask-cloudflared

from flask import Flask
from flask_cloudflared import run_with_cloudflared, get_cloudflared_url

app = Flask(__name__)

@app.route('/')
def hello():
    return 'Hello World'

@run_with_cloudflared
def run():
    app.run()

if __name__ == '__main__':
    run()
    print(get_cloudflared_url())

Requires Python 3.6 or later and a working Cloudflare TryCloudflare service connection.

Verify before relying:

- Whether the package works reliably with Python versions beyond 3.6, given the classifier specifies only 3.6 support
- Current status of Cloudflare's TryCloudflare service and whether it remains stable for production-like use cases

## Package facts

- License: not declared (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 98.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

cloudflare tunnel flask, expose flask app publicly, trycloudflare integration, flask ngrok alternative, temporary public url flask, cloudflared decorator, flask tunneling, tunneling, development-tool, cloudflare

[View on SkillFed](https://skillfed.io/packages/flask-cloudflared) · [View on PyPI](https://pypi.org/project/flask-cloudflared/)