plasmabio · djangoliv · Jun 11, 2026 · Jun 11, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,7 +2,42 @@
 
 ## [Unreleased]
 
-## 0.2
+- Show a loading spinner when navigating from the JupyterLab launcher (e.g. RStudio) inside the iframe
+
+## [0.4]
+
+- Side panel toggle button now displays the PLASMA logo rotated vertically
+
+## [0.3]
+
+- Upgrade tljh-repo2docker
+
+## [0.2]
+
+### User Interface
+
+- JupyterLab is now embedded in a full-screen iframe on the hub home page
+- A retractable side panel provides access to Stop and Home buttons without leaving JupyterLab
+- The side panel toggle button shows the PLASMA logo and auto-expands for 2 seconds on page load
+- A loading overlay with spinner is shown while JupyterLab loads; after 15 seconds without response a Reload button is displayed
+- Links and `window.open` calls from inside the iframe are intercepted to stay in the same tab
+
+### Permissions page
+
+- Added a filter input to search environments by name
+- Compacted the layout to show more environments on screen
+- Fixed appearance in Firefox dark mode
+
+### Ansible
+
+- Improved upgrade reliability: plugins are now force-reinstalled on each run
+- Simplified service restart (single `restart` instead of stop/kill/start sequence)
+
+### Other
+
+- tljh-repo2docker upgraded to 3.0
+- The database URL can now be set via the `TLJH_PLASMA_DB_URL` environment variable
+- Fixed non-unique UID handling in the container entrypoint
 
 ## [0.1] 2020-05-11
 

diff --git a/docs/environments/index.md b/docs/environments/index.md
@@ -35,6 +35,7 @@ After a fresh install, this list will be empty.
 
 prepare
 add
+rebuild
 remove
 update
 ```
diff --git a/docs/environments/rebuild.md b/docs/environments/rebuild.md
@@ -0,0 +1,24 @@
+(environments-rebuild)=
+
+# Rebuilding an environment
+
+To rebuild an environment, click the **Rebuild** button (circular arrow icon) on the right of the
+environment row. A dialog will open, pre-filled with the existing settings:
+
+```{note}
+The **Rebuild** button is only available if the environment belongs to the current user and is not
+currently being built.
+```
+
+```{image} ../images/environments/rebuild-dialog.png
+:align: center
+:alt: Rebuild environment dialog
+:width: 100%
+```
+
+Click **Rebuild Environment** to start the build.
+
+```{warning}
+Users whose server is currently running on this environment will keep using the old image until they
+stop and restart their server.
+```
diff --git a/docs/environments/remove.md b/docs/environments/remove.md
@@ -8,13 +8,7 @@ To remove an environment, click on the `Remove` button. This will bring the foll
 :width: 100%
 ```
 
-After clicking on `Remove`, a spinner will be shown and the page will reload shortly after:
-
-```{image} ../images/environments/remove-spinner.png
-:align: center
-:alt: Removing an environment - spinner
-:width: 100%
-```
+After clicking on `Remove`, a spinner will be shown and the page will reload shortly after.
 
 (remove-error)=
 

diff --git a/docs/images/environments/add-new.png b/docs/images/environments/add-new.png
diff --git a/docs/images/environments/environments.png b/docs/images/environments/environments.png
diff --git a/docs/images/environments/rebuild-dialog.png b/docs/images/environments/rebuild-dialog.png
diff --git a/docs/images/environments/remove-dialog.png b/docs/images/environments/remove-dialog.png
diff --git a/docs/images/environments/remove-image-error.png b/docs/images/environments/remove-image-error.png
diff --git a/docs/images/environments/remove-spinner.png b/docs/images/environments/remove-spinner.png
diff --git a/docs/images/environments/services-navbar.png b/docs/images/environments/services-navbar.png
diff --git a/docs/images/permissions/permissions-empty.png b/docs/images/permissions/permissions-empty.png
diff --git a/docs/images/permissions/permissions-group-dropdown.png b/docs/images/permissions/permissions-group-dropdown.png
diff --git a/docs/images/permissions/permissions-navbar.png b/docs/images/permissions/permissions-navbar.png
diff --git a/docs/images/permissions/permissions-page.png b/docs/images/permissions/permissions-page.png
diff --git a/docs/images/permissions/permissions-spawn.png b/docs/images/permissions/permissions-spawn.png
diff --git a/docs/install/upgrade.md b/docs/install/upgrade.md
@@ -39,6 +39,13 @@ Check out the {ref}`persistence-user-data` section to know more about user data.
 
 ## Running the playbook
 
+```{important}
+Always run `git pull` in the `plasma/` directory before running the playbooks.
+Ansible reads the `ansible/vars/default.yml` file from your **local** copy of the repository,
+not from GitHub. If you skip this step, the playbook will use the versions defined in your
+local file and may not install the latest release.
+```
+
 To perform an upgrade of the setup, you can re-run the playbooks as explained in {ref}`install-ansible`.
 
 Re-running the playbooks will:
-Original file line number
+Diff line change
@@ Expand Up / @@ -35,6 +35,7 @@ After a fresh install, this list will be empty. @@
     prepare
     add
+    rebuild
     remove
     update
     ```