> ## 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

## Common issues

| 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`                                              |
| I can't go to the next line    | Try one of those keybindings `shift+return`, `ctrl+return`, `alt+return`, `ctrl+j` |

## Installation problem on Windows

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

## Linux specific issues

### Copy/paste not working on Linux

Linux users need to have one of the following clipboard utilities installed for copy/paste functionality 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 to find clipboard tools in order of: xclip and xsel.

## Network connection blocked

If you're behind a corporate firewall or proxy, you may need to configure your network settings to allow Symbiotic Code to connect to our API.
You will need to add to your allowlist the following domains:

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

***

<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>
  </p>
</div>

## Use in a docker container

To use Symbiotic Code in a docker container, you need to follow those steps:

1. Download the script and dockerfile [here](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 in the container and can run the symbiotic command to launch the coding agent.