FAQ

Find your symptom; if it is not here, use the "Minimal diagnosis" at the bottom.

Install and start

The Linux installer reports a missing container runtime or network component Run the command the installer prints, then re-run the install command; it resumes. Without a terminal, or if you answer n, the installer never runs sudo. If a run fails after installing, manyoyo doctor finds the cause and prints the command.

The browser did not open automatically The terminal prints a one-time login URL; open it within 60 seconds, or run manyoyo again after it expires. For SSH and other machines without a graphical session see First Run.

I forgot the login password Running manyoyo on the machine signs you in automatically, no password needed. To reset it, run manyoyo setup or edit serverPass in ~/.manyoyo/manyoyo.json.

I want to go back to the previous version after upgradingmanyoyo update --rollback, see Daily Use.

The manyoyo command will not start (after an upgrade) Run the install command again, or run ln -sfn <a version that worked> ~/.manyoyo/app/current (see ls ~/.manyoyo/app for the versions).

manyoyo update or the installer times out Set a proxy in the terminal first, export https_proxy=http://127.0.0.1:7890, then retry (the macOS system proxy is detected automatically). If that still fails, download the files listed on screen by hand, see Install.

Running and images

permission denied Docker / Podman permissions are insufficient. First make sure docker ps runs on its own; see Permission Issues.

pinging container registry failed / image pull failure The registry is unreachable. Check your proxy or build locally, see Image Pull Failures.

Environment variables have no effectenvFile must be an absolute path. Check with manyoyo config show --ef /abs/path/example.env; details in Environment Variable Issues.

manyoyo build fails Most users never need to build. If you must, see Image Build Issues.

Minimal diagnosis

manyoyo doctor                  # check container runtime, image, config and ports
manyoyo doctor --fix            # repair what can be repaired
manyoyo config show -r claude   # the final resolved configuration
manyoyo config command -r claude  # the container command that would run
manyoyo ps                      # container status

Getting help

Open an issue at GitHub Issues with reproduction steps, error logs, manyoyo -v and system information, and a redacted config snippet. More runtime problems are in Runtime Issues.