From 59587dc92efc59af0431ef0c931117c6413a9ed9 Mon Sep 17 00:00:00 2001
From: Michael Collins <15347726+michaeljcollinsuk@users.noreply.github.com>
Date: Thu, 23 Jan 2025 12:26:11 +0000
Subject: [PATCH] Update JupyterLab tunnel docs

---
 .../appendix-docs/app_development.md          |  5 ++++
 .../documentation/tools/jupyterlab/index.md   | 23 ++++++++++++++++++-
 source/tools/jupyterlab/index.html.md.erb     |  2 +-
 3 files changed, 28 insertions(+), 2 deletions(-)

diff --git a/source/documentation/appendix-docs/app_development.md b/source/documentation/appendix-docs/app_development.md
index ad16f31c..6ec9d167 100644
--- a/source/documentation/appendix-docs/app_development.md
+++ b/source/documentation/appendix-docs/app_development.md
@@ -1,3 +1,8 @@
+> **IMPORTANT:**
+> These instructions are for older versions of JupyterLab earlier than v3.6.3/4.1.0.
+> [You can find the latest documentation on running an application locally here](https://user-guidance.analytical-platform.service.justice.gov.uk/tools/jupyterlab/index/html#accessing-a-locally-running-application).
+
+
 # Running your app within Jupyter
 
 It is likely that you will want to preview and test your app before you deploy it.
diff --git a/source/documentation/tools/jupyterlab/index.md b/source/documentation/tools/jupyterlab/index.md
index 225ffd4e..ece08957 100644
--- a/source/documentation/tools/jupyterlab/index.md
+++ b/source/documentation/tools/jupyterlab/index.md
@@ -91,6 +91,27 @@ python3 -m ipykernel install --user --name="pipenv-name" --display-name="My proj
 
 And then select the kernel in Jupyter as [normal](../tools/package-management.html#venv-and-pip).
 
+## Accessing a Locally Running Application
+
+As of version JupyterLab v3.6.3/4.1.0, to access an application running locally (such as Dash or Streamlit), it *must* be running on port `8081`. You can then access it by visiting `https://${USERNAME}-jupyter-lab-tunnel.tools.analytical-platform.service.justice.gov.uk`. As apps are only accessible on port 8081, you can only run one app at a time.
+
+This cannot be accessed by anyone other than yourself as it uses the same authentication method as your tooling.
+
+There is no longer a requirement to run your app (e.g. Dash or Steamlit) on a base url path e.g. `/_tunnel_/8050/`. This is only required for older versions of JupyterLab that are now deprecated.
+
+### Hints and tips
+- To run a Dash app on port `8081` use the `port` arg when using the `app.run` command in your code e.g.:
+    ```
+    if __name__ == '__main__':
+        app.run(port=8081)
+    ```
+- To run a Streamlit app on port `8081` you can use the `--server.port` flag when running the app e.g.
+   ```
+   streamlit run app.py --server.port 8081
+   ```
+    Alternatively, set the server port environment variable in your terminal session before running your app `export STREAMLIT_SERVER_PORT=8081`
+
+
 ## Hidden Files
 
-As per [this](https://jupyterlab.readthedocs.io/en/stable/user/files.html#displaying-hidden-files) documentation, to display or hide the hidden files through the menu `View` -> `Show Hidden Files`.
\ No newline at end of file
+As per [this](https://jupyterlab.readthedocs.io/en/stable/user/files.html#displaying-hidden-files) documentation, to display or hide the hidden files through the menu `View` -> `Show Hidden Files`.
diff --git a/source/tools/jupyterlab/index.html.md.erb b/source/tools/jupyterlab/index.html.md.erb
index 4e3a41f0..344908b8 100644
--- a/source/tools/jupyterlab/index.html.md.erb
+++ b/source/tools/jupyterlab/index.html.md.erb
@@ -1,7 +1,7 @@
 ---
 title: JupyterLab
 weight: 30
-last_reviewed_on: 2022-05-01
+last_reviewed_on: 2025-01-23
 review_in: 2 months
 owner_slack: "#analytical-platform-support"
 owner_slack_workspace: "mojdt"