Troubleshooting

Troubleshooting

Use this page when Coder Studio does not start, cannot reach a provider, or cannot be opened from another device.

Coder Studio Does Not Start

Check status and logs:

coder-studio status
coder-studio logs

Try foreground mode for a direct error:

coder-studio serve --foreground

Browser Did Not Open

Run:

coder-studio status

Open the displayed URL manually.

Port Is Already In Use

Change the port and restart:

coder-studio config --port 8080
coder-studio serve --restart

Provider Is Missing

Coder Studio can open files and terminals without an AI CLI, but Claude and Codex sessions require their matching provider CLIs.

Install the provider CLI, confirm it works in a normal terminal, then start a new session in Coder Studio.

Phone Cannot Open The Workspace

Common causes:

• Phone and computer are not on the same network.
• Wi-Fi guest isolation blocks device-to-device access.
• The computer firewall blocks the port.
• Coder Studio is listening only on localhost.
• VPN, company network, or campus network blocks local device discovery.

For LAN access:

coder-studio config --host 0.0.0.0
coder-studio serve --restart
coder-studio status

Then open:

http://<computer-lan-ip>:<port>

Login Or Password Problems

Reset the password:

coder-studio config --password <new-strong-password>
coder-studio serve --restart

If an IP is blocked after repeated failed attempts:

coder-studio auth ban-list
coder-studio auth unblock --ip <ip-address>

WebSocket Or Connection Issues

Try:

• Refreshing the browser.
• Checking coder-studio status.
• Checking coder-studio logs.
• Confirming the tunnel or network route is still active.
• Restarting the service with coder-studio serve --restart.

Still Stuck

Collect:

• coder-studio status
• Relevant coder-studio logs
• Browser URL used
• Operating system
• Node.js version
• Whether the issue happens locally, on LAN, or through a tunnel