# Testing

{% hint style="info" %}
This is not a comprehensive set of tests but is mostly designed to ensure that your system has been properly installed.
{% endhint %}

{% hint style="info" %}
**What is Jupyter?**

Jupyter lets you run POCS (and other!) commands via a web browser in the form of "notebooks".  You can run these notebooks as long as you are connected to the same network as your PANOPTES unit (for an even more remote setup, check the [forums](https://forum.projectpanoptes.org)!)
{% endhint %}

When POCS is installed there is also a [jupyter](https://jupyter.org/) server started that you can use to access the system and perform tests.  This server is available using the **hostname** of the system (see [Installing OS](/build/software/installation/pocs-installation.md#customize-install-options)) at the following url:  `https://<hostname>:8888`. For our example system this would be <https://PAN021:8888>.

The installation script makes a `/home/panoptes/notebooks` folder that includes a `TestPOCS` notebook that will run through the basics of testing the unit hardware.  You can see this [notebook on github](https://github.com/panoptes/POCS/blob/c1590fa5f0768769530938fe8a91039c821b854e/notebooks/TestPOCS.ipynb).

{% hint style="danger" %} <mark style="color:orange;">**Troubleshooting:**</mark> What if the Jupyter notebook doesn't respond/open ?

* You can run `pocs notebook restart` to restart the notebook
* Check the log for errors: `tail -F $HOME/logs/jupyter-server.log`
* look for entry in the log: "`Jupyter Server is running" at` to see which port is being used. It may not be port 8888, in which case you will need to use this number to connect
  {% endhint %}


---

# 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://www.projectpanoptes.org/build/testing.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.
