Skip to main content

Installing cloudflared

Install cloudflared, the Cloudflare Tunnel client, to start using Cloudflare Tunnels in Xermius.

Easiest method - let Xermius install it:

1. Go to "Cloudflare Tunnels" tab

2. If not installed, see banner:
   ┌────────────────────────────────────────┐
   │ ⚠️ cloudflared not found               │
   │                                        │
   │ Cloudflare Tunnels requires cloudflared│
   │ Would you like to install it?          │
   │                                        │
   │        [Cancel]    [Install Now]       │
   └────────────────────────────────────────┘

3. Click "Install Now"

4. Xermius downloads and installs

5. Installation complete!
   ✓ cloudflared installed
   ✓ Ready to use

Supports:

  • ✅ macOS (Homebrew)
  • ✅ Linux (package manager)
  • ✅ Windows (binary download)

Manual Installation​

macOS​

Using Homebrew (Recommended):

brew install cloudflared

Verify:

cloudflared --version
# cloudflared version 2024.1.5

Linux​

Debian/Ubuntu:

# Add Cloudflare GPG key
sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg | sudo tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null

# Add repository
echo "deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/cloudflared.list

# Install
sudo apt-get update
sudo apt-get install cloudflared

RHEL/CentOS:

# Add repository
curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg | sudo tee /etc/yum.repos.d/cloudflared.repo

# Install
sudo yum install cloudflared

Arch Linux:

yay -S cloudflared

Windows​

Using Package Manager (Recommended):

# Using Scoop
scoop install cloudflared

# Or using Chocolatey
choco install cloudflared

Manual Download:

1. Download from:
   https://github.com/cloudflare/cloudflared/releases

2. Choose Windows binary:
   cloudflared-windows-amd64.exe

3. Rename to: cloudflared.exe

4. Move to: C:\Windows\System32\

5. Or add to PATH

Verify:

cloudflared --version

Verification​

Check installation:

# In terminal
cloudflared --version

# Should show:
cloudflared version 2024.1.5 (built YYYY-MM-DD)

In Xermius:

1. Settings → Integrations → Cloudflare

2. Status section shows:
   ✓ cloudflared installed
   Version: 2024.1.5
   Path: /usr/local/bin/cloudflared

Troubleshooting​

Command Not Found​

Error: cloudflared: command not found

Solutions:

# 1. Check if really installed
which cloudflared

# 2. Check PATH
echo $PATH

# 3. Reinstall
# macOS:
brew reinstall cloudflared

# Linux:
sudo apt-get install --reinstall cloudflared

# 4. Restart terminal/Xermius

Permission Denied​

Error: Permission denied when running

Solution:

# Make executable
chmod +x /path/to/cloudflared

# Or reinstall with proper permissions

Old Version​

Issue: Old cloudflared version

Update:

# macOS
brew upgrade cloudflared

# Linux (Debian/Ubuntu)
sudo apt-get update
sudo apt-get upgrade cloudflared

# Windows (Scoop)
scoop update cloudflared

Next Steps​