> For the complete documentation index, see [llms.txt](https://docs.ceruleansonar.com/c/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ceruleansonar.com/c/sonarview/installation/blueos.md).

# 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="https://2515205857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSYkdyxXfSDQsVcrx8VV1%2Fuploads%2F82K4wxQCuAMJbnx1gDER%2Fimage.png?alt=media&amp;token=ef3313f0-8b64-408c-8035-46f5df95d253" alt=""><figcaption></figcaption></figure>
2. Select SonarView, and click Install

   <figure><img src="https://2515205857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSYkdyxXfSDQsVcrx8VV1%2Fuploads%2FKHuo1VjEMQBo2QN7PGDH%2Fimage.png?alt=media&amp;token=2512affa-e969-4b50-8030-3ec848e669d2" alt=""><figcaption></figcaption></figure>
3. The container will download and start automatically. It will appear in the left sidebar when the process completes

   <figure><img src="https://2515205857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSYkdyxXfSDQsVcrx8VV1%2Fuploads%2FNA32J2IckYkqVTSVIBDh%2Fimage.png?alt=media&amp;token=89cea1af-03bf-4919-b4e1-53f8913b62bc" 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="https://2515205857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSYkdyxXfSDQsVcrx8VV1%2Fuploads%2FbGvxK8xdxWd4MZ2Rr3ja%2Fimage.png?alt=media&amp;token=ab6097d2-a53f-411f-96ca-7aa0f899a945" alt=""><figcaption></figcaption></figure>

Usage

SonarView on BlueOS differs from the desktop app

###

### Additional Options

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

<figure><img src="https://2515205857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSYkdyxXfSDQsVcrx8VV1%2Fuploads%2FAicVirOcNz0gfMj5E7d4%2Fimage.png?alt=media&amp;token=92a3dfc4-2bdc-4134-a9c9-68623febd066" alt=""><figcaption></figcaption></figure>

**View Logs** can be helpful in diagnosing issues and sharing info with support.

**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).

<figure><img src="https://2515205857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSYkdyxXfSDQsVcrx8VV1%2Fuploads%2FlTICowCMBJgoT0BHRTgd%2Fimage.png?alt=media&amp;token=da7fea32-9648-4c6d-a782-fd66d141613f" alt="" width="271"><figcaption></figcaption></figure>

**Defaults:**

Extension Identifier: `ceruleansonar.sonarview`

Docker image: `nicknothom/sonarview`

Docker tag: `1.13.15`

Original Settings / Custom Settings:

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

**Steps to allow the Omniscan 3D to work in BlueOS (1.5.0-beta.26 and 27)**

1. SonarView's web interface must be accessed directly, it will not load by clicking "SonarView" in the BlueOS menu.
2. SonarView runs on port 7077, so on a stock BlueOS instance SonarView can be accessed at <http://192.168.2.2:7077/> . If hostname resolution is working, then <http://blueos.local:7077/> may also work.