Troubleshooting
Start with:
dac doctorIt lists what it checked, marks anything that needs fixing, and says what the consequence is in plain words.
Common problems
"DAC is not running"
Start it with dac start. If it still will not start, dac doctor shows the reason.
"Node.js 22 or newer is needed"
Install a current Node.js release, then run the command again.
I lost the dashboard link
Run dac open. The dashboard only opens from DAC's own link, because the link carries the secret that lets your browser in.
An agent program is missing from the list
DAC only shows agent programs it found on your computer. Check that the program is installed and works in a terminal, then run dac doctor.
An agent says it is not signed in
Open the agent's Settings and sign it in. Signing in to the program on your own computer does not sign in an agent, because each agent keeps its own sign-in. See Signing an agent in.
The container choice is switched off
Docker is not installed or not running. Start Docker, then make the agent again.
Two agents clash over the same network port
Agents running on your computer share its network, so two that each start a server on port 3000 will collide. Each agent is given its own block of ports, but a program that insists on a fixed port ignores it. Running one of the agents in a container gives it a network of its own.
"GitHub sign-in is not set up for this installation yet"
DAC needs a one-time registration with GitHub before the Connect GitHub button appears. Follow the setup steps.
Still stuck?
Open an issue on GitHub with what you did, what you expected, and what dac doctor printed. Remove any keys or links from what you paste.