How To Use WireGuard or Hysteria2

What You Need

• A phone, tablet, or computer.
• The WireGuard app or a compatible Hysteria2 client installed on your device.
• Your PhotonMark WireGuard .conf file, QR code, HY2 URI, or HY2 YAML profile from Client Portal.

Quick Steps

1. Install the WireGuard app or a compatible Hysteria2 client.
2. Import your WireGuard configuration file, scan the QR code, or import the HY2 URI/YAML profile.
3. Enable the tunnel and check traffic is flowing.

Install WireGuard App

• iPhone/iPad: App Store.
• Android: Google Play or official APK.
• Windows/macOS/Linux: official packages from wireguard.com/install.

If you cannot access the Mac App Store, use the macOS ZIP package from our Download page. See FAQ steps.

Use Hysteria2

Open the Client Portal, copy the HY2 URI or YAML profile from your Hysteria2 instance, and import it into a compatible Hysteria2 client. If DNS does not look right after connecting, enable Fake DNS or remote DNS in the client settings, then reconnect.

Use On Mobile (iOS/Android)

Open WireGuard, tap plus, choose Import from file or archive (or scan QR), then turn the tunnel on. If sent or received bytes increase, the tunnel is working.

Use On Windows/macOS

Open WireGuard, click Add Tunnel, import your config file, then click Activate. Status should become active and transfer counters should move.

Use On Ubuntu (CLI)

If not installed:

sudo apt install wireguard

Bring up your tunnel:

sudo wg-quick up /path/to/your.conf

Verify IP Is Changed

Before and after connecting, check your public IP using an IP checker (for example https://www.myip.com/). If the address changes, your VPN route is working.

Troubleshooting

• No traffic: reconnect tunnel, then test another network (Wi-Fi/4G/5G).
• Some sites blocked: renew IPv4 in Client Portal.
• Still failing: contact support with your instance name and screenshot.