Skip to Main Content
UCLA Logo EPSS IT

EPSS Department VPN (WireGuard) — User Setup Guide

Connect to the EPSS Department VPN using WireGuard to reach internal apps, admin pages, and other department resources from off campus.

You need your EPSS username, EPSS/AD password, and an internet connection.

Open EPSS VPN portal →

1

Go to the EPSS VPN portal

  1. Open a web browser and go to https://v.epss.ucla.edu.
  2. Log in with your EPSS username and EPSS/AD password.
2

Create a VPN configuration

  1. On the portal page, locate New Configuration.
  2. For Profile / Type, choose WireGuard.
  3. In the Name field, enter a label for your device (for example: Laptop, Office-PC, iPhone, or Android).
  4. Click Create / Download to generate your configuration.

Tip: Create a separate profile for each device (for example, one for your laptop and one for your phone).

3

Install WireGuard (Windows)

  1. Download WireGuard from wireguard.com/install and install it like a normal program.
  2. Open WireGuard.
  3. Click Add Tunnel → Import tunnel(s) from file.
  4. Choose the downloaded .conf file.
  5. Click Activate.

Connected? You should see the tunnel marked as Active and traffic counters increasing.

4

Install WireGuard (macOS)

Install WireGuard

  1. Download WireGuard from wireguard.com/install.
  2. Open the downloaded .dmg file.
  3. Drag WireGuard into the Applications folder.
  4. Open WireGuard from Applications.

If WireGuard does not open, check System Settings → Privacy & Security and click Allow if prompted.

Method 1 — Import from file

  1. Download the configuration file (.conf) from the EPSS VPN portal.
  2. Open WireGuard → Import Tunnel(s) from File.
  3. Select the downloaded file.
  4. Toggle the tunnel ON.

Method 2 — Copy and paste

  1. On the EPSS VPN portal, create a WireGuard configuration and open its details.
  2. Copy the full configuration text (it starts with [Interface] and includes [Peer]).
  3. Open WireGuard → Add Empty Tunnel.
  4. Delete any existing text, paste the configuration, name the tunnel (for example, EPSS VPN), and click Save.
  5. Toggle the tunnel ON.

Connected? The tunnel should show Active and traffic should begin.

Alternative if WireGuard fails on macOS

If the app does not open or crashes (for example, due to macOS security or managed-device restrictions):

  1. Download Tunnelblick.
  2. On the EPSS portal, create a configuration using OpenVPN (Prefer UDP).
  3. Download the file and double-click it to import.
  4. Click Connect.
5

Install WireGuard (iPhone / Android)

  1. Install WireGuard from the App Store or Google Play.
  2. On the EPSS VPN portal, generate a WireGuard configuration and display the QR code.
  3. Open the WireGuard app → Add a tunnel → Create from QR code.
  4. Scan the QR code.
  5. Toggle the tunnel ON.
6

Verify it works

  1. Keep WireGuard ON.
  2. Open the internal EPSS resource you were given (for example, internal apps or admin pages).

If it loads while the VPN is on, you are done.

7

Common issues

It connects but nothing works

  • Disconnect and reconnect WireGuard.
  • Confirm you imported the correct profile for the correct device.
  • If you recently changed your EPSS password, generate and download a new profile.

I don’t see a download / it gave me OpenVPN instead

  • Go back and make sure you selected WireGuard (not OpenVPN).

I can’t log into the portal

  • Verify your EPSS username and password work for other EPSS services.
  • If your password recently changed, try again or contact EPSS IT.
8

Need help?

Email help@epss.ucla.edu and include:

  • Your device type (Windows, macOS, iPhone, or Android)
  • A screenshot of the error, if any