Skip to main content

Android

We don’t ship our own Android client yet. Until we do, CHIMERA on Android works through trusted third-party clients with a config you paste once. Setup takes ~3 minutes.

1

WireGuard

The recommended path

Install WireGuard for Android:
Open the app, tap + → Create from clipboard, paste the config we issue below. Toggle the switch — you’re connected. Speed: best of all three paths. Fallback for blocked networks: not great, use Reality below if WireGuard times out.
2

Reality (DPI-evading)

For hostile networks

Install v2rayNG:
Open v2rayNG, tap + → Import config from clipboard, paste the vless://... URI we issue below. Tap to connect. This route survives most state-level DPI by mimicking a TLS handshake to a real innocuous website. Speed: 70-80% of WireGuard.
3

Shadowsocks-2022

Backup path

Install Shadowsocks Android:
Use only if 1 and 2 are blocked. Open the app, tap + → Import from clipboard, paste the ss://... URI. This is older protocol design but widely deployable; some censors haven’t caught up yet.

Get your config

Already have a CHIMERA subscription? Run this from any terminal — it returns a JSON document with all three configs (WireGuard, Reality, Shadowsocks) ready to paste.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.chimera.tw/v1/config/android

On Android, you can run the same request from Termux (F-Droid) or use any HTTPS client. The response includes a wireguard_conf field — copy that block, then in the WireGuard app tap + → Create from clipboard.

Why we don’t have our own app yet

A real Android VPN app means writing Kotlin against Android’s VpnService API, integrating WireGuard userspace stacks, packaging our protocol selector, and getting through Google Play’s VPN content review (jealous of operator anonymity). Mullvad and IVPN both took 1-2 years to ship their own client, and they had real companies behind them.

Our roadmap has a custom client around month 9-12 after launch (see chimera-mobile/ANDROID_PLAN.md in the open-source repo). Until then, third-party clients give you the same network path with full transparency about what code is running on your phone.

The WireGuard, V2Ray and Shadowsocks projects are all open source, on F-Droid, and have been independently audited. They don’t know anything about CHIMERA — they just speak the same protocols our exits speak.