# Computer Connection

Once your Vagon Computer is up, the session relies on a clean link between your local client and the cloud machine. Most connection issues come from a stale browser, a blocked extension, a missing permission, a Dock Menu toggle, or a brief network interruption during a file transfer. Work through the sections below in order.

## Cannot Connect from the Browser

If the computer is started but the browser will not connect or the stream fails to load:

* Update Chrome or Edge to the latest stable version.
* Disable extensions that may block scripts, media, or WebRTC.
* Clear site permissions, then allow microphone and clipboard permissions again when prompted.
* Try an incognito or private window to rule out cached state.
* Reload the page once. If it still fails on the second attempt, switch to the Vagon Desktop Application.

## Cannot Connect from the Desktop App

If the Vagon Desktop Application will not connect:

* Install the latest version of the Vagon Desktop Application.
* Restart the app.
* Sign out and sign in again.
* Test the same computer from a browser to compare behavior. If the browser also fails, the issue is not the client itself.

{% hint style="info" %}
When in doubt, run the same test in both clients. If only one fails, the problem is on that client. If both fail, look at the network, the account, or the Vagon Computer state.
{% endhint %}

## Both Browser and Desktop App Fail

If both clients fail, the issue is unlikely to be the client itself. Investigate:

* Network, VPN, proxy, or firewall settings on your local network.
* Account or subscription status in the dashboard.
* Region distance, if you recently traveled.
* Vagon Computer state — check whether it is suspended, out of credit, or mid-update.

## Audio Not Working

If sound is missing during your session, audio is most likely toggled off in the Dock Menu rather than broken.

1. Click the **Settings** icon on the right side of your Vagon Computer to open the **Dock Menu**.
2. In the **Shortcuts** section, find the **Sound** icon and click it to turn audio on.

{% hint style="info" %}
If you do not need audio for a session, leaving sound off reduces browser resource usage and can free up bandwidth for the video stream.
{% endhint %}

If sound is enabled in the Dock Menu but you still hear nothing:

* Check the volume and output device on your local computer.
* Verify the audio device inside Windows on the Vagon Computer (right-click the speaker icon in the system tray).
* Allow audio permissions for the Vagon site in your browser, or reinstall the Vagon Desktop Application.

## File Transfer Interrupts or Fails

File transfers in Vagon depend on a stable connection between your local device and the Vagon Computer, so most transfer issues come from network interruptions or a session ending mid-transfer.

### Upload Problems

* Keep the session and browser tab open until the upload finishes.
* Retry from a stable network.
* Check available storage inside the Vagon Computer.
* Try uploading fewer files at once.

### Download Problems

* Confirm the file exists in the expected location on the Vagon Computer.
* Avoid stopping the computer until the download finishes.
* Retry from the Vagon Desktop Application if browser download behavior is unreliable.

### Large Transfers

Large transfers are more sensitive to connection interruptions. When possible, compress many small files into one archive before transferring.

## Next Steps

{% content-ref url="/pages/6qzIh39BHLN505DsYmIn" %}
[Computer Initialization](/computer/troubleshooting/computer-initialization.md)
{% endcontent-ref %}

{% content-ref url="/pages/RAZObY49RDgKOCsGaOwW" %}
[Connection Performance](/computer/troubleshooting/connection-performance.md)
{% endcontent-ref %}

{% content-ref url="/pages/dOrYDK5NrHlLBbnJ3opQ" %}
[Vagon Desktop Apps](/computer/features/vagon-desktop-apps.md)
{% endcontent-ref %}

{% content-ref url="/pages/iosVTQk1MfV77ifsCOJr" %}
[Vagon Files Directory](/computer/features/vagon-files-directory.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vagon.io/computer/troubleshooting/computer-connection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
