Getting started

Tunnelio lets you chat with the Ollama models on your own computer from any browser, your phone included. Setting it up takes a few minutes: install the app on the computer, create an account and pair.

What you need

  • A computer with Ollama, on Windows 10 or 11, macOS (Apple silicon or Intel) or Ubuntu and Debian. Your models run there, and your conversations are kept there.
  • A browser on the device you want to chat from: a phone, a laptop, a work computer.
  • An account at app.tunnelio.app, or on a server of your own.

You do not need a VPN, to open ports on your router or to change any network setting. The computer app keeps an outgoing connection, the way a browser does.

1. Install the computer app

Download the file for your system from the download section of this site.

  • macOS: open Tunnelio-macos.dmg and drag Tunnelio to Applications. The installers are not signed yet, so the first time you open Tunnelio, macOS says it could not verify the app and does not open it. Click Done, open System Settings → Privacy & Security, scroll down to Security: next to “Tunnelio was blocked to protect your Mac”, click Open Anyway, confirm Open Anyway and enter your password or Touch ID. On macOS 13 and 14 it is simpler: right-click (or Control-click) Tunnelio in Applications and choose Open, then Open again. Only the first time.
  • Windows: unzip Tunnelio-windows.zip into a folder you keep and open tunnelio.exe. The first time, Windows shows “Windows protected your PC” (an unknown publisher): click More info, then Run anyway. Only the first time.
  • Ubuntu and Debian: install the package with sudo apt install ./Tunnelio-ubuntu.deb and open Tunnelio from your applications.

The app lives in the menu bar or the system tray, next to Ollama. Its menu shows how things stand, for example Ollama: running · Relay: connected. If Ollama is not running, the menu offers to start it, or to download it when it is not installed. Turn on Start at login so the computer is always reachable when it is on.

Want to be sure the file you downloaded is the one the project published? See How to verify your download.

2. Create your account

At app.tunnelio.app, choose Create account, type your e-mail and a password, and confirm with the code we e-mail you.

Your password does more than sign you in: it also seals the list of your paired computers, which the server keeps without being able to read it. Choose a long password you do not use anywhere else. The app refuses passwords that are easy to guess.

3. Pair the computer

Pairing is how a browser and the computer app get to know each other. It happens once per browser.

  1. In the computer app's menu, choose Pair a device…. A page opens on the computer with a 12-symbol code and a QR code. They are valid for 5 minutes.
  2. Then pick the way that suits you:
    • On your phone: point the camera at the QR code and open the link. Sign in if asked; the web app pairs on its own.
    • In another browser: in the web app, open Devices → Add a device → Enter pairing code and type the 12 symbols.
    • On the computer itself: the page's Pair this device button opens the web app with the code already filled in.
  3. The web app says Paired with and the computer's name, and the computer shows a notification.

Only the first 4 symbols of the code go to the server, so it can put your browser in touch with the right computer. The other 8 never reach it: they are what proves the browser is in front of your computer. A code works once; if it expires, choose Pair a device… again.

Once a browser is paired, the others where you sign in with the same password get the computer too. See Devices and account.

4. Download a model and chat

  • Models lists what is installed on the computer and, under Download other models, the Ollama library with the size of each download. Click a size and the computer downloads it, showing the progress at the top of the list. You can close the browser meanwhile: the computer finishes the download on its own.
  • New chat: choose the computer and the model under the message box, and type. The answer appears as it is written. The conversation is kept on the computer, not on the server.

Next