Installing the emergency client
Where to download and how to install olcbox on Android, iPhone, Windows, macOS and Linux, how to import the connection link you get in your cabinet or by email — and why to do it all in advance, before blocks arrive.
Your emergency connection is a link starting with olcrtc://: you get it in your cabinet right after requesting it (and by email if you requested it by email). To use that link you need an app — olcbox.
How emergency access works and what to do during a block is on the Emergency access page. This page is only about the app: where to get it and how to install it.
Install it in advance, while the internet still works normally. Once the network switches to allow-lists there will be nowhere to download it from: app stores and download sites will most likely be unreachable. The app takes little space and does nothing until you launch it.
Download
Direct links to the files. Pick your system.
Works on any modern phone. For very old (32-bit) devices there is a smaller build — use it only if the regular one refuses to install.
This is an .apk file installed directly, bypassing Google Play. Android will ask for permission to install apps from this source — that's normal for this method; allow it for the browser or file manager you open the file from.
On iPhone the installation is harder than elsewhere and needs a computer. The app is not in the App Store and never will be, so you have to install it yourself — this is called sideloading. Do it in advance and don't put it off: under a block you will not be able to.
See "Installing on iPhone" below.
Also available: an MSI package for managed installs and a portable ZIP build that runs without installing.
Windows may show a SmartScreen warning about an unknown publisher — the app is not signed with a certificate. Click "More info" → "Run anyway".
For Apple Silicon Macs (M1 and newer): download
For Intel Macs: download
Not sure which one you have? Apple menu → "About This Mac": if the "Chip" line says Apple M1/M2/M3/M4, take the first option.
The app is unsigned, so macOS will refuse to open it the first time. Go to System Settings → Privacy & Security, find the message about the blocked app near the bottom and click "Open Anyway".
On macOS, just like on iPhone, the client runs in proxy mode only — there is no system-wide tunnel; traffic goes through it for apps that can use a proxy.
Runs without installing. After downloading, make it executable:
chmod +x Olcbox-*-linux-amd64.AppImage
./Olcbox-*-linux-amd64.AppImageProxy mode works right away. A full system tunnel additionally needs iproute2, access to /dev/net/tun and running as root — otherwise you stay in proxy mode.
The links always point to the current build — there is nothing to update by hand. If a download fails, try again a little later, or take the file from the Emergency access block in your account.
Installing on iPhone
Apple does not let you simply install an app from a file — you need a computer and a helper program. The method is free, with one important caveat.
The free option has to be re-signed every 7 days. After a week the app stops launching until you connect the phone to the computer again. If it expires exactly when a block hits, you're left without emergency access. So either refresh the signature weekly, or use a paid Apple Developer account ($99/year), where the signature lasts a year.
With AltStore (no computer needed every time)
Install AltServer on a Windows or macOS computer from altstore.io.
Connect your iPhone by cable and install AltStore onto it via AltServer (the program walks you through it and asks for your Apple ID — it is only used to sign the app).
Download the .ipa file from the link above onto the iPhone itself.
Open AltStore on the phone → My Apps tab → "+" in the corner → pick the downloaded file.
Trust the app: Settings → General → VPN & Device Management → select your Apple ID → "Trust".
As long as the phone and the computer are on the same network, AltStore refreshes the signature by itself. If the computer is far away, connect the phone to it once a week.
With Sideloadly (simpler, but needs the computer each time)
Install Sideloadly on a computer, connect the iPhone by cable, drag the .ipa file into the window, enter your Apple ID and press Start. Then trust the app in the phone's settings as above.
On iPhone the emergency client only works in proxy mode — traffic goes through it for apps that can use a proxy, not for the whole system.
Connecting with the link you received
Copy the link starting with olcrtc:// — from the Emergency access block in your cabinet (there's a copy button, and a QR code if the client is on another device) or from the reply email if you requested it by email.
Open olcbox and add a connection — the app offers to paste the link from the clipboard.
Press "Connect".
The link is tied to the call you created and stays valid for the whole session — you can import it again if you reinstall the app. While the session runs, the cabinet keeps showing it, so it can be copied again; the email, however, is sent once. Once the session ends, you need a new call and a new request.
If something doesn't work
The app won't install on Android. Check that installing from this source is allowed, and try the smaller build.
The app stopped opening on iPhone. Most likely the 7-day signature expired — connect the phone to the computer and refresh it via AltStore or Sideloadly.
The olcrtc:// link isn't accepted. Make sure you copied all of it, including the olcrtc:// prefix. Links are easily truncated when copying from mail apps.
The connection doesn't come up. The session may have expired — create a new call and request a new connection. If that doesn't help either, the video service itself doesn't get through on your network, and emergency access won't work there.
The speed is low. That's expected. Measured: about 14 Mbit/s down, but only 0.7–0.9 Mbit/s up, with 175–235 ms latency. Watching video and reading mail is comfortable; sending a large file, making a video call or gaming is not. The 15–20× asymmetry is a property of the disguise itself, not a fault.