Using the GUI Application

This guide covers how to use the InTunnel GUI application to create and manage tunnels.

Starting the Application

Windows

Double-click intunnel-gui.exe or find InTunnel in your Start menu.

macOS

Open InTunnel.app from your Applications folder or Launchpad.

Linux

Run from terminal:

./intunnel-gui

Or find InTunnel in your applications menu.

Main Interface

The GUI has a clean, simple interface with these main areas:

Connection Panel

Field	Description
Token	Your authentication token from the dashboard
Subdomain	Your custom subdomain (e.g., "myapp")
Port	Local port to expose (default: 3000)
Domain	Choose .cloud, .online, or .tech

Status Area

Shows current connection status:

• 🔴 Disconnected - Not connected to tunnel
• 🟡 Connecting - Establishing connection
• 🟢 Connected - Tunnel is active

Tunnel URL

When connected, displays your public URL that you can click to open.

Creating a Tunnel

Step 1: Enter Your Token

1. Copy your token from the InTunnel Dashboard
2. Paste it into the Token field

Step 2: Configure Settings

1. Enter your desired Subdomain (or leave default)
2. Set the Port your local service runs on
3. Select your preferred Domain

Step 3: Connect

1. Click the Connect button
2. Wait for the status to show "Connected"
3. Your tunnel URL will appear

Step 4: Access Your Service

• Click the tunnel URL to open in browser
• Share the URL with others

Disconnecting

Click the Disconnect button to close the tunnel. The status will change to "Disconnected".

Auto-Reconnect

The GUI automatically reconnects if the connection is lost. You'll see:

1. Status changes to "Reconnecting..."
2. Automatic retry every few seconds
3. Status returns to "Connected" when successful

Tips and Tricks

Quick Copy URL

Click the tunnel URL to copy it to your clipboard.

Minimize to Tray

The application can run in the background. Look for the InTunnel icon in your system tray.

Remember Settings

The GUI saves your last used settings (except the token for security).

Troubleshooting

"Invalid Token" Error

• Check that you copied the complete token
• Verify the token is active in your dashboard
• Ensure you're using the correct token for the subdomain

"Port Already in Use"

• Make sure your local service is running on the specified port
• Check no other tunnel is using the same port

"Connection Failed"

• Check your internet connection
• Try a different domain (.cloud, .online, or .tech)
• Check the Status Page for service issues

GUI Doesn't Start

Windows: Install WebView2 runtime from Microsoft Linux: Install webview dependencies:

# Ubuntu/Debian
sudo apt install libwebkit2gtk-4.0-dev

# Fedora
sudo dnf install webkit2gtk3-devel

Keyboard Shortcuts

Shortcut	Action
Enter	Connect (when form is filled)
Escape	Disconnect
Ctrl/Cmd + Q	Quit application

Next Steps

• Learn about Security Best Practices
• Explore the CLI Client for automation
• Check the FAQ for common questions