# BlueOS

The SonarView BlueOS Extension is recommended on uncrewed vessels (USV, ROV) for a few key reasons:

* SonarView's server **always** has a solid connection to the sonar. Packets are never dropped, even if you lose communications with the vehicle.
* Your telemety radio or communication link will not be used for raw sonar data, leaving more bandwidth for piloting. This will increase the usable range of a wireless link. 
* Your settings will be preserved across different computers or mobile devices
* Remote access to sonars over the internet is possible in this configuration

1. Navigate to BlueOS Extension Store 

   <figure><img src="/files/4FQlF3a8v7iHAaJp7KJT" alt=""><figcaption></figcaption></figure>
2. Select SonarView, and click Install&#x20;

   <figure><img src="/files/ilv4jnLNn4gcuNGiHUjt" alt=""><figcaption></figcaption></figure>
3. The container will download and start automatically. It will appear in the left sidebar when the process completes&#x20;

   <figure><img src="/files/AvVsu9GltQPaNE0tULVF" alt=""><figcaption></figcaption></figure>
4. Opening SonarView via the left sidebar will open it within the BlueOS UI Frame. SonarView can also run in an independent browser window by navigating to <http://blueos.local:7077>

   <figure><img src="/files/oZeZ1sNjflnwMTnSsWuS" alt=""><figcaption></figcaption></figure>

Usage

SonarView on BlueOS differs from the desktop app&#x20;

###

### Additional Options

Some more options are available by navigating to the BlueOS Extensions tab, and selecting "Installed" on the top.&#x20;

<figure><img src="/files/f99mNUdXw6ixBNZQemEt" alt=""><figcaption></figcaption></figure>

**View Logs** can be helpful in diagnosing issues and sharing info with support.&#x20;

**Edit** allows you to manually choose a version of SonarView or change the path for the logging directory in the host OS. You can see all the available tags for SonarView [here](https://hub.docker.com/repository/docker/nicknothom/sonarview/tags).&#x20;

<figure><img src="/files/udTVQlbTYkTBwjHJBzZa" alt="" width="271"><figcaption></figcaption></figure>

**Defaults:**

Extension Identifier: `ceruleansonar.sonarview`

Docker image: `nicknothom/sonarview`

Docker tag: `1.13.15`

Original Settings / Custom Settings:&#x20;

```
{
  "HostConfig": {
    "NetworkMode": "host",
    "Binds": [
      "/usr/blueos/userdata/SonarView:/userdata"
    ]
  }
}
```


---

# 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.ceruleansonar.com/c/sonarview/installation/blueos.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.