Answer-first summary

Par ou commencer dans la documentation InstaTunnel ?

Ordre recommande : installer le CLI, s authentifier, lancer le premier tunnel, puis passer a MCP/webhooks/referrals selon votre cas. Utilisez CLI Flags et Troubleshooting au quotidien.

Derniere revision : March 5, 2026
Compatibilite : La documentation principale couvre CLI v1 par defaut et MCP --transport v2 pour les clients streaming.

Commande rapide

instatunnel auth login -e you@example.com && instatunnel 3000 --subdomain docs-demo

Erreurs courantes et corrections rapides

  • Auth non persistee-Executez instatunnel auth set-key it_your_api_key pour enregistrer votre cle localement.
  • Erreurs 401 de signature webhook-Utilisez les guides de verification de secret sur /docs/webhooks avant les tests de production.

Preuves et confiance

Utilisez ces references pour evaluer la compatibilite, la fiabilite et la securite.

Cadence des releases

Les release notes CLI et docs sont mises a jour en continu, avec des notes de compatibilite par version.

Voir les release notes

Controles de securite

Consultez le security whitepaper pour les politiques, l auth et les protections operationnelles.

Ouvrir le security whitepaper

Domaines personnalises

Use a domain you control with an InstaTunnel tunnel. Custom domains are available on Pro and Business plans and must be verified through DNS before traffic can be routed.

Use a subdomain when possible

We recommend a hostname such as app.example.com or hooks.example.com. A normal root domain such as example.com cannot use a CNAME with many DNS providers; it requires ALIAS, ANAME, or CNAME flattening support.

Set up a custom domain

  1. 1. Create the tunnel from the dashboard

    Open the dashboard, create a tunnel, and enter the hostname you own in the Custom Domain field. The dashboard then shows a unique TXT value for that tunnel.

  2. 2. Add the TXT ownership record

    Copy the exact record name and value from the dashboard. For app.example.com, the record name will look like _instatunnel-verification.app.example.com and the value starts with itv_.

    Do not reuse a TXT value from another tunnel. The value is unique to the pending setup request.

  3. 3. Add the CNAME record

    Type: CNAME
    Name: your custom hostname
    Target: tunnel.instatunnel.my

    DNS provider forms differ: for app.example.com, the Name field may be app instead of the complete hostname. With Cloudflare, set this record to DNS-only while the domain is connected. Do not point it at the VPS IP address.

  4. 4. Verify the domain in the dashboard

    Return to the dashboard and select Verify Domain. The TXT record must be visible in public DNS first. If the check reports that the record was not found, wait a few minutes and retry.

    InstaTunnel does not route the hostname or start SSL setup before this verification succeeds.

  5. 5. Connect your local application

    instatunnel connect 3000 --domain app.example.com

    After verification, SSL setup begins automatically. Keep the CNAME in place and allow a few minutes for DNS and certificate setup before testing HTTPS.

Requirements and troubleshooting

The hostname must be yours

We require a matching DNS TXT record before associating a custom domain with a tunnel. Domains and subdomains under instatunnel.my or instatunnel.com cannot be used as custom domains.

TXT record not found

Confirm that the record name is not duplicated by your DNS provider, the value matches exactly, and the record has propagated publicly. Some providers append your domain automatically when you enter a relative host name.

The root domain cannot be a CNAME

Use a subdomain such as app.example.com, or use your DNS provider's ALIAS, ANAME, or CNAME flattening feature. Do not replace this with an A record to the InstaTunnel VPS IP.

Besoin d un chemin rapide ?

Consultez les offres puis suivez un guide de demarrage.

Pour les endpoints MCP sur Pro/Business, utilisez : instatunnel 8787 --mcp.