Connect a node
Open Connect a node in the sidebar. There are three ways to link a machine. If you don't have an account yet, create one when the sign-in page asks; you come back to the same step afterwards.
Install link
Choose Generate install link and run the command on the new machine:
curl -fsSL https://goethe.sh/i/<code> | bash
The command installs goethe and links the node to your workspace. The link works once and expires after 1 hour. If it has expired, create a new one.
goethe login
On a node that already has goethe:
goethe login
It prints a link and a code, then waits. Open the link (or Connect a node in the console), enter the code, check the hostname, and choose Approve. The code expires after 15 minutes. A node that is already logged in says so; run goethe logout first to link it to another workspace.
Without a browser
Use an auth key instead of the browser approval:
goethe login --authkey msh_ak_...
--authkey - reads the key from standard input, which keeps it out of the process list.
Unlink
goethe logout
This removes the node from its workspace and deletes the local credentials. If the platform cannot be reached, the local link is still removed and the node shows as offline until you remove it in the console.
How long a login lasts
By default a node stays logged in until you log it out or remove it. You can give a node a lifetime under Key expiry on its page (7 days to 1 year); it counts from the node's last goethe login. When a node's login expires it stops sending heartbeats and cannot download kernel packs until you run goethe login on it again. Models already installed keep running.