localoy.ai

Run on a server

Everything Localoy does runs in one background program, so a server gets the same Localoy a desktop does, and you use it from the browser on your own computer. The binaries have no dependencies, and no container is needed.

Install

For Linux and macOS, on x64 and ARM. Run it as the user Localoy should work as, over SSH:

curl -fsSL https://localoy.ai/install.sh | sh
  1. It installs localoy (alias loy) and localoyd to ~/.local/bin. No root is needed. If that folder is not on your PATH, it prints the line to add.
  2. It starts Localoy as a background service (systemd on Linux, launchd on macOS), so it comes back after a reboot or a crash, and keeps running after you log out.
  3. It signs you in with a code: open the address it shows on any device, check the code matches, and approve.

Use it from your own computer

Localoy only listens on the server itself, never on the network. Reach it through SSH from your own computer:

ssh -L 2468:127.0.0.1:2468 you@your-server

Then, on the server, run localoy open --print and open the link it prints in your browser. After that, http://127.0.0.1:2468 keeps you signed in whenever the SSH tunnel is up.

Without systemd

In a container or anywhere without a systemd user session, Localoy can’t start by itself. The installer says so and prints the two commands to run:

~/.local/bin/localoyd &
~/.local/bin/localoy open --print

Options

  • INSTALL_DIR=/usr/local/bin installs system-wide.
  • LOCALOY_VERSION=<tag> installs a specific release instead of the latest.
  • LOCALOY_NO_SERVICE=1 installs only, without the background service.

Check it and update it

localoy status says whether Localoy is running, which version, and who is signed in. It updates itself: once a day it looks for a new version, checks it really comes from us, and switches over when no agent is working. With a browser tab open, it asks you first with a Restart button.

Keep in mind

The permission model travels with the agent, so where it runs (your Mac, a box you rent, a cloud) is a capacity decision rather than a safety one. Read safety and control before you give one access.