> ## Documentation Index
> Fetch the complete documentation index at: https://docs.symbioticsec.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common issues and how to solve them

## Quick reference

| Issue                          | Solution                                                                               |
| ------------------------------ | -------------------------------------------------------------------------------------- |
| `command not found: symbiotic` | Ensure `~/.local/bin` is in your PATH and restart your terminal                        |
| Authentication fails           | Verify your token is valid in the portal and hasn't expired                            |
| Permission denied              | Run `chmod +x ~/.local/bin/symbiotic`                                                  |
| Can't go to the next line      | Use one of these keybindings: `shift+return`, `ctrl+return`, `alt+return`, or `ctrl+j` |

***

## Installation issues

### Windows

If you have trouble installing Symbiotic Code on PowerShell, try launching the install command with Git Bash, which you can download [here](https://gitforwindows.org/).

If the issue is related to PowerShell execution policy, run PowerShell as Administrator and execute:

```powershell theme={null}
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

### Permission denied (macOS/Linux)

If you get a permission error when installing globally:

```bash theme={null}
# Option 1: Use sudo
sudo npm install -g @symbioticsec/code

# Option 2: Configure npm to use a user directory
mkdir ~/.npm-global
npm config set prefix "~/.npm-global"
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
```

***

## Platform-specific issues

### Copy/paste not working on Linux

Linux users need one of the following clipboard utilities installed for copy/paste to work.

**X11 systems:**

```bash theme={null}
apt install -y xclip
# or
apt install -y xsel
```

**Wayland systems:**

```bash theme={null}
apt install -y wl-clipboard
```

**Headless environments:**

```bash theme={null}
apt install -y xvfb
# and run:
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0
```

Symbiotic Code will detect if you're using Wayland and prefer `wl-clipboard`, otherwise it will try `xclip` then `xsel`.

### Using Symbiotic Code in a Docker container

1. Download the script and Dockerfile [here](https://github.com/SymbioticSec/mintlify-docs/raw/refs/heads/main/assets/symbiotic_code_docker.zip)
2. Unzip the file
3. Launch Docker Desktop
4. Make the script executable:

```bash theme={null}
chmod +x run-symbiotic.sh
```

5. Run the script:

```bash theme={null}
./run-symbiotic.sh
```

6. You are now inside the container and can run the `symbiotic` command to launch the coding agent.

***

## Network and connectivity

If you're behind a corporate firewall or proxy, you may need to allowlist the following domains for Symbiotic Code to connect to the API:

* `api.symbioticsec.ai:443`
* `llm-proxy.symbioticsec.ai:443`

**Proxy configuration:** If behind a corporate proxy, configure npm:

```bash theme={null}
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080
```

**npm registry blocked:** If the npm registry is inaccessible:

* Check proxy settings: `npm config get proxy`
* Verify your firewall allows access to `registry.npmjs.org:443`
* Contact IT to whitelist the npm registry

***

## Health check script

Run the following command to verify that your system is ready for Symbiotic Code:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/SymbioticSec/mintlify-docs/refs/heads/main/assets/symbiotic-health-check.js | node
```

The script checks:

1. **Node.js** — Ensures Node.js is installed (v14+ recommended)
2. **npm** — Verifies npm is available
3. **Global install permissions** — Tests ability to install global npm packages
4. **Execution policy** (Windows only) — Checks PowerShell execution policy
5. **Proxy configuration** — Displays current proxy settings
6. **npm registry access** — Tests connectivity to `registry.npmjs.org:443`
7. **Required endpoints** — Tests connectivity to:
   * `api.symbioticsec.ai:443`
   * `llm-proxy.symbioticsec.ai:443`

Once all checks pass, install with:

```bash theme={null}
npm install -g @symbioticsec/code
```

**If issues persist**, save the health check output and contact support:

```bash theme={null}
node symbiotic-health-check.js > healthcheck-results.txt 2>&1
```

***

<div className="bg-gray-50 dark:bg-white/5 p-6 border border-gray-200 dark:border-white/10">
  <p className="text-lg font-semibold text-gray-900 dark:text-white mb-2">
    Need help?
  </p>

  <p className="text-gray-600 dark:text-white/80 text-sm">
    Contact us using the dedicated Slack channel or email us at <span>[support@symbioticsec.ai](mailto:support@symbioticsec.ai)</span> with your health check results, OS version, and network environment.
  </p>
</div>