> ## Documentation Index
> Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt
> Use this file to discover all available pages before exploring further.

# atoti.Session.link

#### *property* Session.link *: Link*

Link to the session.

Return it from a notebook code cell to display it.

* If used inside JupyterLab with [`atoti-jupyterlab`](./atoti_jupyterlab#module-atoti_jupyterlab) installed, the JupyterLab extension will try to reach the session in this order:

1. [Jupyter Server Proxy](https://jupyter-server-proxy.readthedocs.io/) if it is enabled.
2. `f"{session_protocol}//{jupyter_server_hostname}:{session_port}"`.
3. [`url`](./atoti.Session.url#atoti.Session.url).

* If used in another environment, [`url`](./atoti.Session.url#atoti.Session.url) wil be used.

When [`url`](./atoti.Session.url#atoti.Session.url) is used and the session is running on another machine, the link may not be reachable.
In that situation, the session may be reached from `f"{public_ip_or_domain_of_machine_hosting_session}:{session_port}"`.

A path can be added to the link with `/`.

### Example

Linking to an existing dashboard:

```pycon theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
>>> dashboard_id = "92i"
>>> path = f"#/dashboard/{dashboard_id}"
>>> link = session.link / path
```