Connect Computer — Linux

Connect a Linux computer so PHNTM One can show its readings and the projects you approve.

This works with Linux computers only. Windows and macOS are not supported. The companion program you install on the computer cannot send work to PHNTM One's AI.

How to

Connect a Linux computer

On PHNTM One:

  1. On Home, tap More.
  2. On the Workspace card, tap Connect computer. The screen shows a setup address and three fingerprints (long codes of letters and numbers).

On the Linux computer:

  1. Open the setup address in the web browser. It starts with https://.
  2. If the browser warns about the certificate, open the certificate details. Compare its SHA-256 fingerprint with the website fingerprint on PHNTM One's screen. Continue only if every character matches. If it differs, or the browser cannot show it, stop.
  3. Download the ZIP file. Before you open it, run sha256sum phntm-computer-linux.zip in a terminal. The result must match the ZIP fingerprint on PHNTM One's screen. If it differs, delete the file.
  4. Extract the ZIP. Open a terminal in its phntm-computer folder and run sh install.sh.
  5. The installer shows PHNTM One's address and fingerprint. Check them. It then waits for a code.

Back on PHNTM One:

  1. Choose what the computer may share (see below).
  2. Tap Installer ready — create code. Enter the device password if asked.
  3. Type the code into the installer. The code works once, for five minutes.
  4. Wait until PHNTM One shows “Authenticated and connected”.

Choose what the computer may share

Tick or untick each permission before you create the code:

To change them later, open Connect computer again, tick or untick, and tap Save permissions.

Disconnect a computer

  1. On PHNTM One, open Connect computer and tap Revoke connection.
  2. On the computer, systemctl --user stop phntm-computer stops the companion. sh uninstall.sh removes it.

Good to know

If something goes wrong

What you seeWhat to do
“Secure computer setup is unavailable.”Check that PHNTM One is on your network, then try again later.
A fingerprint does not match.Stop. Do not trust the connection or run the file.
The installer cannot find PHNTM One.Put both on the same network. Check that the computer can look up .local names. Tap Check appliance network details for the device's addresses.
“Paired, but offline.”Open the setup page on the computer again and run its installer to start the companion.
“Pairing code was not confirmed. Wait a moment before trying again.”Wait a moment, then tap Installer ready — create code again.

Privacy

Readings and the Black Box history are kept on PHNTM One. They are not sent to PHNTM or to any cloud. Black Box keeps numbers only: processor, memory, storage, network totals, uptime and, where Linux reports them, temperature and graphics readings. Files, screen, clipboard, sound and network contents are never collected. Black Box history is not in the regular backup. Use Export this computer’s evidence to keep a copy, and Erase retained Black Box history to delete it.

More detail

Computer Black Box

Black Box helps you see what was happening around a slowdown. It keeps the readings from the last day, a summary for every five minutes, and up to 100 bookmarks and observations. Tap Mark something happened to add your own bookmark. Older readings are dropped when the limits are reached. The computer's clock is marked as unverified and never used to order events. Process names are kept only if you tick them: at most five names with their processor and memory use, never their details.

Project Resume

Tap Inspect on a selected project folder. It shows the branch, whether files have changed, recent changes, an activity chart for everyone who worked on it, and your project note. Project Resume / Timeline shows changes and approved workflow runs side by side. It does not claim that one caused the other.

The companion's records

The companion keeps a record of each finished task. These records are kept within fixed size limits, and a new connection is refused rather than deleting old records. The README in the ZIP explains requirements, recovery, and the status and unpair commands. Stop the companion before you connect it again.

Related topics

From the device manual for software 0.9.0 (November 15, 2026). Your device serves the manual for its installed software; where this copy and your device differ, your device is right.