Troubleshooting
Port in use
12:00:00.000 ERRO port 8080 is in use; pick another with --port, or leave it outAnother program listens on that port. Run sind ui --port 8081, or leave --port out so that sind takes a free port.
A second sind ui opens the first
sind ui is already running: http://127.0.0.1:41873/?token=...sind ui recorded the running UI in $XDG_RUNTIME_DIR/sind/ui.json. The second command prints the URL of that UI, opens it in your browser with --open, and exits. Normally only one UI runs for your user at a time.
To start a new one, press Ctrl-C in the terminal of the running UI. If the UI is gone but the record is left over, the next sind ui starts a new one.
If XDG_RUNTIME_DIR is not set, sind ui keeps no record, so each sind ui starts its own UI on its own port.
Docker is not reachable
The Overview shows Docker is not reachable. The pages show the data that sind ui read last. Open Doctor for the cause and the fix. Or run sind doctor in a terminal, as described in Diagnostics.
The page says the link is old or wrong
The page Open sind ui from its address says that this browser is not signed in, or that the link holds an old or wrong token. The token is new with each run. Use the URL that the running sind ui printed, or the one that the second command printed: run sind ui again in a terminal, and it prints the URL of the running UI. A bookmark of an older run does not work. A tab of an older run that is still open is refused too, as its session is gone. Open the new URL.
Connection lost
A banner at the top says Connection lost and the time of the data on the page. The page dims, and its buttons wait. The UI tries to connect again by itself, and the banner goes away when it is back. Retry tries at once.
If sind ui stopped, start it again, and open the URL that it prints. The old tab does not come back. When the new sind ui listens on the same port, as with --port, the banner says sind ui restarted: press Sign in again, and open the new URL.
A page says Not found
The page names the address and says what is missing: a realm, a cluster, a node, a tab or a task. It offers the closest match first, such as a cluster of the same name in another realm, or a node with a similar name. Then it offers the list that holds what you asked for. A cluster or node that is gone was most likely deleted. sind ui keeps the last 25 commands that ended, until it stops; Activity lists the runs of the activity log. An address of a cluster without its realm, such as /clusters/dev, opens that cluster when only one realm has it. A ?realm= that names no realm offers the realms with a similar name.
Opened by another host name
This server answers to its loopback address only.The browser sent another host name, such as localhost, so the UI refused the request. Open the URL that sind printed, with 127.0.0.1 and the same port.
The browser does not open
sind ui opens a browser only with --open, and even then not in an SSH session, or on Linux without a display (DISPLAY or WAYLAND_DISPLAY). It always prints the URL: copy it into a browser on this machine, or forward the port as described in Use it from another machine.
A run says “no end recorded”
The activity log has no end for this run, and its last event is more than an hour old. Its command was most likely killed, for example with kill -9, so it could not write its end. Check with sind get cluster what the command left, and delete it if needed. A run that sind ui started ends when its command ends, with the outcome of the command.
A command waits for the realm lock
Running now on the Overview shows the command that holds the lock of the realm, and that yours waits for it. Your command goes on when the other one ends. Open Activity to see the runs; the page of the run that waits links the run that holds the lock. When no command holds the lock but the realm stays locked, for example after a command was killed, Needs you shows a Lock row that names the command that took it and those that wait for it. If the other command hangs, stop it: press Stop… if the UI started it, or press Ctrl-C in its terminal. See Realms for the lock.