Skip to content

Olib-AI/owl-sidecar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Owl Sidecar

Owl Sidecar

Turn a device you own into a private residential exit for Owl Browser.

Install it on a home or office machine, pair it to your Owl account with a code, and your browser can route traffic out through that device. Your traffic goes straight from the browser to the sidecar. It never passes through Olib servers.

Latest release Platform Notarized License

Download · Install · Pairing · Docs · olib.ai


What is Owl Sidecar?

Owl Sidecar is the exit side of the Owl proxy tunnel. You run it on a device with the connection you want to use, and Owl Browser sends traffic through it.

A residential connection looks like an ordinary home user, so sites treat it as one. The sidecar opens a normal outbound connection to each target and forwards raw bytes, so the browser keeps its own TLS handshake end to end. There is no extra header, no rewrite, and nothing on the wire that marks the traffic as proxied.

Once paired, the app runs quietly in the menu bar or system tray. It shows whether it is online, how many connections are active, and how much has been transferred. You can pause it at any time without unpairing.

How the connection works

  • Peer to peer. The browser and the sidecar connect directly and carry your traffic between them. Olib runs a small coordination service that helps the two sides find each other, and then it steps out of the path. It never carries your data.
  • No open ports. The sidecar makes an outbound connection only, so it works from a home network behind NAT with nothing forwarded.
  • Paired to your account. A device is usable only by browsers signed in to the same account. Pairing uses a short code from the portal and a key that is generated on the device and never leaves it.
  • You stay in control. Enable, disable, and configure a device from the portal. Pause or unpair from the app.

Install

Owl Sidecar ships for macOS (Apple Silicon), Windows (x64), and Linux (x64 and arm64). Pick your platform below, then follow the pairing guide to connect it to your account.

macOS

  1. Download owl-sidecar-0.1.0-macos-arm64.tar.gz from the latest release.
  2. Extract it and move OwlSidecar.app to your Applications folder.
  3. Open it. The app is signed with the Olib AI Apple Developer ID and notarized by Apple, so it opens without a Gatekeeper override.

Windows

  1. Download owl-sidecar-0.1.0-windows-x64-setup.exe from the latest release.
  2. Run the installer. It adds a Start-menu shortcut (and an optional desktop shortcut), and can start Owl Sidecar automatically at login. Uninstall any time from Settings > Apps.

Prefer a portable build? Download owl-sidecar-0.1.0-windows-x64.zip, extract it, and run owl-sidecar.exe directly.

Linux

The Linux build is a command-line binary for servers, with no desktop GUI and libc6 as its only dependency. Pair it once and run it headless.

Debian and Ubuntu based systems can install the package:

sudo dpkg -i owl-sidecar-0.1.0-linux-amd64.deb   # or -linux-arm64 on ARM

For other distributions, use the tarball or the install script:

curl -fsSL https://raw.githubusercontent.com/Olib-AI/owl-sidecar/main/scripts/install.sh | sh

The script detects your platform, downloads the matching release, and installs the binary to ~/.owl-sidecar/bin with a shim on your PATH. It also works on macOS if you prefer the command line to the app.

Pairing

You need an Owl account with the proxy feature enabled. From the portal, open Proxy Devices, add a device, and copy the code it shows. Enter that code in the app and it registers itself and comes online. Full steps are in the pairing guide.

Documentation

Support

Owl Sidecar is part of Owl Browser by Olib AI.

About

Turn a device you own into a private residential exit for Owl Browser. Peer to peer, cross-platform.

Topics

Resources

License

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors