codus
← All documentation

My phone says "No live desktops" but Codus is running

The cloud is not seeing a recent connection from the expected desktop. A saved project can remain in List while its computer is absent from Quadrants; saved records and a live connection are different things. Check the desktop's connection and GitHub account before signing out or trying to run the task again.

Before you start

The computer must be awake, connected to the internet and running Codus. Opening the website on a phone does not wake the computer or start its local servers. Keep any unsent work safe before changing sessions.

What to check

  1. On the computer, confirm Codus is running and the intended project is open.
  2. Look for an amber reconnecting indicator. If it persists, check the computer's network connection.
  3. Open Settings → Cloud account. A signed-out or anonymous desktop needs Sign in with GitHub.
  4. Compare the GitHub account on the desktop and phone. A familiar saved folder does not rule out an account mismatch.
  5. Refresh the phone's Quadrants view and look for the expected machine and project.
  6. If the network works but the desktop session remains disconnected, save unsent work, then sign out and back in through Cloud account. Use the same intended GitHub account.

Signing in again is a recovery step, not a guaranteed cure for every sync or service failure. Do not repeatedly sign out, recreate folders or delete local records.

How do I know it worked?

The expected machine reappears as live on Quadrants, with the correct project. A task's run control becoming available proves a target is visible; confirm activity in the desktop terminal after executing it.

If the machine is live but recent tasks or Done entries are missing, use task and Done sync troubleshooting. If the machine still does not appear, report its name, the app version, the time and the displayed error.

Read as markdownUpdated 2026-09-09