Error codes · Terminal
PULSE-TERM-001 The terminal did not open: the background terminal process did not start
What does this mean
Pulse could not open the terminal: the background process in which the terminal shells live did not start. The rest of Pulse works.
Why does this happen
On macOS and Linux, terminal shells live in a separate background process - this is how tabs and commands running in them survive Pulse exit and restart. If this process did not start, did not respond on time, did not start Pulse, or terminated immediately, the terminal has nowhere to work. What exactly happened is written in “More details”: “the terminal daemon did not rise after ... s”, “did not respond to the greeting”, “did not start: token or version did not match”, “completed”.
Why the process didn't go up is recorded in its own log pty-daemon.log — he lies next to the Pulse log and goes into the report.
On Windows there is no background process, and this error does not occur there.
What to do
- Click Retry.
- Didn't help - open "Settings → Terminal", turn off "Terminals survive exiting Pulse" and restart Pulse. Terminals will work without a background process, only tabs and commands will no longer survive exiting Pulse.
- Send a report - the background process log will be included in it, and we will see the reason.
When to write to support
Write to us if “Retry” does not help: the reason is visible only in the background process log, but it goes into the report. Click “Send report” in the error card - a report form will open, where the code and details have already been entered, the secrets are hidden in them. Add what you did before the error and click “View and Send”: the window will show exactly what is left - check and click “Submit”. If the cloud is turned off, the button is called “View and save” - send the resulting file to us in any way.