Troubleshooting and FAQ
Find your symptom below: the first line under it is the fix, and most fixes take one step. For anything not here, write to Support in the dashboard or to support@detachbox.com.
My preview says nothing is listening on the port. What's wrong?
Start the server on 0.0.0.0. On localhost or 127.0.0.1 the preview can't reach it:
npm run dev -- --host 0.0.0.0
vite --host 0.0.0.0
next dev -H 0.0.0.0
rails s -b 0.0.0.0
uvicorn app:app --host 0.0.0.0
Open the preview from the terminal that runs the server: in Terminals, pick Files and previews above it. The list flags a server that listens on localhost only. Ports from 1024 to 65535 work. More in Preview URLs.
A preview says "This preview is private". Why?
If the terminal is yours, pick Sign in with another account and sign in with the one that owns it: the link leads to a terminal of an account this browser is not signed in to. To let someone else open it, make the port public.
The agent says it is signed out, or my account row reads "Signed out". How do I fix it?
Open Subscriptions & keys, pick Reconnect on the row, and sign in to the same account. The subscription lost its login, and its agents wait until you reconnect; every launch stays on it. See Subscriptions.
I switched the subscription of a launch, but the agent still uses the old one. Why?
Pick the account name above the terminal, choose the new account, and pick Restart on this conversation when it asks. Or open a new terminal of the launch. A running terminal keeps the account it started with until its agent starts again.
A terminal says "Stopped on the limit". What now?
Pick one of three fixes; the row shows when the subscription resets:
- Tick Continue after the limit resets in the launch, and detachbox types "continue" the minute the limit resets.
- Connect a second account and tick Rotate subscriptions as they run out in the launch.
- On a Codex account with resets left, pick Use a reset on Subscriptions & keys.
Continue after the limit resets and Rotation explain the first two.
A terminal says "Stopped to keep your reserve". How do I let it run?
Open Subscriptions & keys, pick Keep a reserve on the row, and pick Lift reserve until 8:00 PM, which names the time the week resets. The account goes back to its launches at once, and the reserve comes back by itself after the reset. Or pick Switch subscription in the notice over the terminal.
The agent was stopped because the Compute ran out of memory. What do I do?
Pick Restart terminal in the notice, and the agent picks up its conversation. Your terminals together needed more memory than your size has, so the system stopped the largest program. If it keeps happening, stop the containers you don't need or pick Change size for more memory. CPU, memory and disk has more.
A terminal ran out of processes and nothing starts in it. Why?
Pick Restart terminal for a fresh container, and set init: true on that service in your compose file. A program in the terminal started processes and never collected them when they finished, until all 32,768 were taken; the notice names the program when it can.
Codex won't connect. OpenAI refuses the code.
Turn on device code sign-in first. In ChatGPT, open Settings → Security and switch on device code authorization for Codex. Then pick Get a new code in the dialog. A code expires after 15 minutes.
Can I copy auth.json from my Compute to my laptop?
No: sign in to Codex and Claude on your laptop separately. That file holds only an access token, and our server renews it for detachbox alone.
Pasting a screenshot does nothing. Why?
Allow clipboard access for my.detachbox.com in the site settings (the icon left of the address), then paste again: the browser is blocking it for the site. On the first paste, look for the browser's prompt by the address bar.
A photo from my iPhone did not upload. Why?
Pick it from Photos rather than Files, or save it as JPEG first, then send it again with Paste a photo. The browser could not turn it into a format agents read, and the terminal named the photo.
Voice input is missing in Firefox. Why?
Use Chrome, Edge or Safari: voice input runs on the browser's speech recognition, and Firefox has none. If dictation stops at once, allow the microphone for my.detachbox.com in the site settings.
I don't get push pings on my iPhone. How do I turn them on?
Add detachbox to the Home Screen: Safari on an iPhone sends pings only to the Home Screen app. Open my.detachbox.com in Safari, tap Share, then Add to Home Screen. Open detachbox from that icon, go to Notifications, and pick Turn on for this browser. Then pick Send a test ping.
Pings stopped arriving at night. Are they broken?
Check Quiet hours on Notifications. Between From and To, in the time zone shown on the page, routine events send no ping by push, Telegram or email. Emails already pending, and any out-of-memory alert, wait until quiet hours end. The Terminals list still shows every agent that waits.
Switching to a smaller plan was refused. Why?
Free up space, then switch again. What you store, counted at full size, doesn't fit the smaller disk; the message names how much your Compute stores, projects included, and how much the smaller size holds. Find the largest folders with:
du -sh --apparent-size ~/* /work/* | sort -h
My Compute stopped and says the payment did not come through. Is my data gone?
No. Pay the open invoice under Billing before day 14 and you are back in your files. Your Compute is suspended from day 3 after the failed payment, and the account disk with your projects and home folders stays until day 14.
My tmux sessions are gone after a node reboot. Where did they go?
Open the terminal: the agent is already back on the conversation it had, waiting for your next word. A node reboot ends every running process and tmux session. Your terminals come back on their own, with their packages, Docker images and files, and your projects and home folders stay on the account disk. Docker containers with a restart: policy start again by themselves. A terminal started or restarted in the 15 minutes before the reboot comes back without its agent: Restart terminal on this conversation brings it back on that conversation.
A terminal I left ended by itself. Why?
Open a new terminal to carry on: your files in the project and its home folder are all there. A terminal with no agent running in it and nobody on it for 3 hours ends to free its slot, and Activity shows when.
A page the agent opened never showed up. Why?
Allow pop-ups for my.detachbox.com: the browser blocked it. To have previews open without asking, switch on Open previews in this browser by themselves under Settings → Terminal → Pages the agent opens. A page on another site opens by itself once you always allow its host from the terminal's prompt.
Go tests fail with "no such file or directory" for files next to the test. Why?
Turn the default off for the project with go env -w GOFLAGS= in its terminal (an empty value overrides it), or set GOFLAGS in the environment. Go in your terminals builds with -trimpath, so its build cache keeps one copy of each package instead of one per agent worktree path. Under -trimpath, runtime.Caller returns no directory, and a test that opens files beside itself through it looks in the wrong place.
I can't open another terminal. Why?
End one you no longer need with × in its bar and New terminal opens a new one, or move up with Change plan. Your size sets how many terminals run at once: 3 on Start, 5 on Pro, 8 on Max, 10 on Business, 15 on Business Plus, 20 on Business Max, 30 on Business Ultra. Ending a terminal stops every program in it. After a move to a smaller size, the terminals already open keep running, and a new one opens once you are under the new limit.
Dropping a folder into the terminal fails. How do I upload it?
Zip the folder and drop the zip, or select the files inside it and drop those. Files up to your plan's limit go through: 100 MB on Start, up to 10 GB on Business Ultra.
My connection dropped in the middle of an upload. Do I start over?
No. The upload waits for the connection and picks up from the last piece that reached the terminal; meanwhile the terminal shows "Connection lost. Resuming where it stopped…". Coming back online resumes it at once. If the terminal stays out of reach for about a quarter of an hour, the upload stops and says so: drop the file again.
My file is too large to drop. What can I do?
Zip or split the file and drop the parts, or move up with Change plan. Your plan sets the largest file you can drop: 100 MB on Start, 250 MB on Pro, 500 MB on Max, 1 GB on Business, 2 GB on Business Plus, 5 GB on Business Max, 10 GB on Business Ultra.
Packages I installed with sudo are gone. Why?
Keep tools you need every time in /home/dev, for example a binary in ~/.local/bin or a package from npm i -g, and every terminal of that project has them. A package from sudo lives in the terminal that installed it and ends with it, or with its restart; every new terminal starts from the current image.
Writes fail with "No space left on device". What now?
Click the resource meters in the top bar and pick Clear caches under the disk: it empties the package and build caches of every home folder at once. Your projects and home folders filled the account disk, so find the rest with du -sh --apparent-size ~/* /work/* | sort -h in a project's terminal (~ is that project's home folder) and delete what you no longer need. Or pick a bigger size with Change plan on Compute: a bigger disk applies at once.
My git login or gh is gone in a project. Why?
Sign in once in that project's terminal, and every terminal of the project has it. Every project has its own home folder, so logins, keys and tool settings live with the project, and your other projects never see them.
A project says "Setup stopped". What do I do?
Fix the address or folder right on the project page and pick Try again: the same project is set up again from what you give. The message under it says why the clone or copy failed, often a mistyped address or a private repository with no git sign-in. For a private repository, sign in to git in a shell terminal first: gh auth login or glab auth login.