> ## Documentation Index
> Fetch the complete documentation index at: https://tunnelfleet.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenVPN on Linux

> Connect to a TunnelFleet OpenVPN server from Linux.

<Steps>
  <Step title="Install OpenVPN">
    On Debian/Ubuntu:

    ```bash theme={null}
    sudo apt update
    sudo apt install openvpn
    ```
  </Step>

  <Step title="Download the profile">
    Download the `.ovpn` file (TCP or UDP) from TunnelFleet.
  </Step>

  <Step title="Connect">
    ```bash theme={null}
    sudo openvpn --config ~/Downloads/your-server-openvpn-udp.ovpn
    ```

    Enter the VPN username and password when prompted.
  </Step>
</Steps>

### Save credentials (optional)

Create a credentials file with mode `600`:

```bash theme={null}
cat > ~/.ovpn-auth <<'EOF'
your-username
your-password
EOF
chmod 600 ~/.ovpn-auth
```

Then:

```bash theme={null}
sudo openvpn --config ~/Downloads/your-server-openvpn-udp.ovpn --auth-user-pass ~/.ovpn-auth
```

## Verify

In another terminal:

```bash theme={null}
curl ifconfig.me
```

## systemd (optional)

Copy the profile to `/etc/openvpn/client/` and enable a client unit for your distribution's OpenVPN package layout. Exact unit names vary — prefer the interactive command above until the connection is proven.

## Troubleshooting

| Issue                       | Fix                                                   |
| --------------------------- | ----------------------------------------------------- |
| `AUTH_FAILED`               | Confirm username/password; sync user in the dashboard |
| `TLS Error`                 | Wrong profile/port or firewall blocking               |
| Permission denied on config | Ensure your user can read the `.ovpn` file            |