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:
- On Home, tap More.
- 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:
- Open the setup address in the web browser. It starts with
https://. - 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.
- Download the ZIP file. Before you open it, run
sha256sum phntm-computer-linux.zipin a terminal. The result must match the ZIP fingerprint on PHNTM One's screen. If it differs, delete the file. - Extract the ZIP. Open a terminal in its
phntm-computerfolder and runsh install.sh. - The installer shows PHNTM One's address and fingerprint. Check them. It then waits for a code.
Back on PHNTM One:
- Choose what the computer may share (see below).
- Tap Installer ready — create code. Enter the device password if asked.
- Type the code into the installer. The code works once, for five minutes.
- Wait until PHNTM One shows “Authenticated and connected”.
Choose what the computer may share
Tick or untick each permission before you create the code:
- Live read-only vitals and selected Git activity: ticked.
- Record rolling Black Box history here: ticked. It keeps a history of the computer's numbers on PHNTM One.
- The top five process names: not ticked.
- Search explicitly shared folders: not ticked.
- Run named workflows approved on the computer: not ticked.
To change them later, open Connect computer again, tick or untick, and tap Save permissions.
Disconnect a computer
- On PHNTM One, open Connect computer and tap Revoke connection.
- On the computer,
systemctl --user stop phntm-computerstops the companion.sh uninstall.shremoves it.
Good to know
- Black Box recording is ticked when you create a code. Untick it first if you do not want a history kept.
- Searching folders and running workflows need permission on both the computer and PHNTM One. A workflow runs the approved program as your user on the computer. Approve only programs you trust.
- There is no remote control of the computer: no remote shell, no screen capture and no clipboard capture. The companion opens no network port.
- Revoking stops further contact. Work already started on the computer may finish there; stop it there if needed.
- Work is never repeated by itself after a restart or a disconnect. A result that was not reported stays unknown.
- Readings are what the computer reports. A warning line is an observation, not a diagnosis.
If something goes wrong
| What you see | What 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.