plexora 0.0.7__tar.gz → 0.0.8__tar.gz

{plexora-0.0.7/plexora.egg-info → plexora-0.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plexora
-Version: 0.0.7
+Version: 0.0.8
 Summary: OpenSeadragon-based cellular image viewing and analysis tool.
 License-Expression: LicenseRef-Plexora-Academic-1.0
 Requires-Python: <3.14,>=3.12

{plexora-0.0.7 → plexora-0.0.8}/plexora/askpass.py

@@ -87,6 +87,31 @@ def _request(url, payload=None, timeout=10):
     return json.loads(body) if body.strip() else {}
 
 
+def asking_process():
+    """Which ssh is asking, or None when that cannot be known.
+
+    One connection to a cluster runs three ssh processes and two of them
+    authenticate to the SAME host, so they ask the same question word for word.
+    Plexora reuses an answer across hops but must not reuse one that a hop has
+    already refused, and those two cases are only distinguishable by which
+    process is asking -- identical text otherwise.
+
+    The POSIX helper `exec`s this interpreter, so this process's parent IS the
+    ssh that wants an answer, and it stays the same pid across that ssh's own
+    retries. The Windows wrapper is a .bat and cannot exec, so the parent there
+    is a transient cmd.exe that would look like a new asker every time --
+    exactly the wrong way round. So Windows reports nothing and Plexora falls
+    back to treating any repeated question as a refusal, which costs a person
+    one extra typing and never replays a rejected secret.
+    """
+    if os.name == "nt":
+        return None
+    try:
+        return f"pid:{os.getppid()}"
+    except OSError:
+        return None
+
+
 def ask(prompt, env=None):
     """Post `prompt` back to Plexora and block until somebody answers it.
 
@@ -107,7 +132,8 @@ def ask(prompt, env=None):
         timeout = DEFAULT_TIMEOUT
 
     opened = _request(_url(base, "prompt", token),
-                      {"nonce": nonce, "prompt": str(prompt)})
+                      {"nonce": nonce, "prompt": str(prompt),
+                       "asker": asking_process()})
     prompt_id = opened.get("id")
     if not prompt_id:
         raise AskpassError(opened.get("error") or "Plexora refused the prompt")

{plexora-0.0.7 → plexora-0.0.8}/plexora/cli.py

@@ -948,6 +948,10 @@ def _build_node_parser():
         help="Seconds to wait for the node to answer. Raise it when a "
              "segmentation mask has to be converted first.",
     )
+    node_connect.add_argument(
+        "--install", action="store_true",
+        help="Install or update Plexora on that host first: `pip install "
+             "--upgrade plexora`, in the environment --remote-command names.")
     node_connect.add_argument("--plugins", default=None,
                               help="Plugins the node should be able to run.")
 
@@ -1000,6 +1004,7 @@ def _run_node_connect(args):
         remote_port=args.remote_port,
         timeout=args.timeout,
         plugins=args.plugins,
+        install=bool(getattr(args, "install", False)),
         register=register,
     )
 
@@ -1169,6 +1174,15 @@ def _build_connect_parser():
              "where the images are on the cluster and the cell table never "
              "left your laptop. Repeat for each.",
     )
+    connect.add_argument(
+        "--install",
+        action="store_true",
+        help="Install or update Plexora on the remote host before launching "
+             "it: `pip install --upgrade plexora`, in the environment "
+             "--remote-command names. Off by default, because it writes to "
+             "that machine. Saved with --save, and the same switch the "
+             "Settings form calls \"Install or update Plexora\".",
+    )
     connect.add_argument(
         "--no-local-node",
         action="store_true",
@@ -1291,6 +1305,12 @@ def connect_kwargs(args, profile=None):
                       or (profile.name if profile is not None else None)),
         "node_port": args.node_port,
         "local_node": not args.no_local_node,
+        # An opt-in either way round, so the flag does not have to beat a saved
+        # value: `--install` on the command line, or a profile that was saved
+        # with it on. Nothing here can turn it off for one run, which is the
+        # right asymmetry -- forgetting to install is a stale Plexora, and
+        # installing by surprise is a write to somebody's account.
+        "install": bool(getattr(args, "install", False) or saved("install", False)),
     }
 
 
@@ -1334,6 +1354,7 @@ def _save_remote(name, target, kwargs):
         serve=tuple(kwargs["also_serve"]),
         local_serve=tuple(kwargs["local_serve"]),
         node_name=kwargs["node_name"],
+        install=kwargs["install"],
     ))
     print(f"Saved as {name!r}. Next time: plexora connect {name}")
 

{plexora-0.0.7 → plexora-0.0.8}/plexora/client/src/css/main.css

@@ -3090,6 +3090,88 @@ nav {
     color: var(--text-muted);
 }
 
+/* A switch shaped as one of the form's own grid cells, so the grid places it
+   beside the box above wherever the dialog is wide enough for two columns.
+   Everything about it that is not layout — the track, the thumb, the travel,
+   the focus ring — is the Settings page's switch at the same sizes, because
+   these are the same control in two places and a user who has seen one should
+   recognise the other. */
+.connect-switch {
+    flex-direction: row;
+    align-items: flex-start;
+    justify-content: space-between;
+    gap: var(--space-3);
+    margin: 0;
+    cursor: pointer;
+}
+
+/* Left alone where the grid has already paired it with the box above -- and
+   widened to the whole row where it would otherwise sit alone in the left
+   column with the toggle stranded mid-dialog. `:last-child:nth-child(odd)` is
+   exactly "the odd one out of a two-column grid"; in the one-column layout a
+   narrow dialog falls back to, every cell spans anyway and this changes
+   nothing. */
+.connect-form > .connect-switch:last-child:nth-child(odd) {
+    grid-column: 1 / -1;
+}
+
+.connect-switch-text {
+    display: flex;
+    flex-direction: column;
+    gap: var(--space-1);
+    min-width: 0;
+}
+
+/* Focusable but not visible: the track is the control a mouse sees, and the
+   input is the one the keyboard and the accessibility tree see. */
+.connect-switch-input {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    opacity: 0;
+    margin: 0;
+    pointer-events: none;
+}
+
+.connect-switch-track {
+    flex: none;
+    position: relative;
+    width: 32px;
+    height: 19px;
+    margin-top: 1px;
+    background: var(--surface-2);
+    border: 1px solid var(--border-subtle);
+    border-radius: 999px;
+    transition: background var(--duration-fast) var(--ease-standard),
+                border-color var(--duration-fast) var(--ease-standard);
+}
+
+.connect-switch-thumb {
+    position: absolute;
+    top: 2px;
+    left: 2px;
+    width: 13px;
+    height: 13px;
+    background: var(--text-muted);
+    border-radius: 50%;
+    transition: transform var(--duration-fast) var(--ease-standard),
+                background var(--duration-fast) var(--ease-standard);
+}
+
+.connect-switch-input:checked + .connect-switch-track {
+    background: var(--accent-channel);
+    border-color: var(--accent-channel);
+}
+
+.connect-switch-input:checked + .connect-switch-track .connect-switch-thumb {
+    background: var(--surface-0);
+    transform: translateX(13px);
+}
+
+.connect-switch-input:focus-visible + .connect-switch-track {
+    box-shadow: 0 0 0 3px var(--accent-channel-soft);
+}
+
 /* Shut on arrival. What is inside is the escape hatch for a preset that is
    almost right — a different partition, a `plexora` ssh cannot find — and
    opening it by default would put a cluster's flag syntax in front of the

{plexora-0.0.7 → plexora-0.0.8}/plexora/client/src/css/settings.css

@@ -815,6 +815,21 @@
     margin-bottom: var(--space-4);
 }
 
+/* A group title with a control on the end of it. The row keeps the title's own
+   bottom margin so the form below sits where it always did -- the switch is a
+   passenger on an existing row, not a row of its own. */
+.remote-group-head {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: var(--space-4);
+    margin-bottom: var(--space-4);
+}
+
+.remote-group-head .remote-group-title {
+    margin-bottom: 0;
+}
+
 .remote-examples,
 .remote-ports {
     font-size: 0.8rem;
@@ -922,6 +937,57 @@
     box-shadow: 0 0 0 3px var(--accent-channel-soft);
 }
 
+/* The same switch, sized to sit on a line of text rather than to own a block.
+   Everything it does not restate -- the track's colours, the thumb's travel,
+   the focus ring -- is inherited from the rules above, so the two cannot drift
+   into looking like two different controls.
+
+   `flex: none` and `align-items: center` are what make it a passenger: the
+   full-width version stretches and top-aligns because it carries a label and a
+   sentence of hint, and this one carries three words. */
+.remote-switch-inline {
+    flex: none;
+    align-items: center;
+    justify-content: flex-start;
+    gap: var(--space-3);
+    padding: 0;
+    white-space: nowrap;
+}
+
+.remote-switch-inline .remote-switch-label {
+    font-size: 0.8rem;
+    color: var(--text-secondary);
+}
+
+.remote-switch-inline .remote-switch-track {
+    width: 32px;
+    height: 19px;
+    margin-top: 0;
+}
+
+.remote-switch-inline .remote-switch-thumb {
+    top: 2px;
+    left: 2px;
+    width: 13px;
+    height: 13px;
+}
+
+.remote-switch-inline .remote-switch-input:checked
++ .remote-switch-track .remote-switch-thumb {
+    transform: translateX(13px);
+}
+
+/* Narrow cards put the title and the switch on two lines rather than letting
+   either shrink: the title is uppercase and letter-spaced, so it wraps badly,
+   and the switch label is the thing being turned on. */
+@media (max-width: 520px) {
+    .remote-group-head {
+        flex-direction: column;
+        align-items: flex-start;
+        gap: var(--space-2);
+    }
+}
+
 /* -- what a job asks for ------------------------------------------------- */
 
 .remote-reveal {

{plexora-0.0.7 → plexora-0.0.8}/plexora/client/src/js/services/connectionModal.js

@@ -41,19 +41,38 @@ window.PlexoraConnectionModal = (function () {
 
     const Remotes = () => window.PlexoraRemotes;
 
-    //: The five things a connection does, in order, with what each is called
-    //: while it is happening. `queued` marks the step that only exists for a
-    //: profile whose Plexora runs inside a scheduler job -- drawing it for a
-    //: plain ssh host would promise a wait that is never coming.
+    //: The things a connection does, in order, with what each is called while
+    //: it is happening. Two of them are conditional, and each is drawn only
+    //: for a profile that actually does it: `queued` for one whose Plexora
+    //: runs inside a scheduler job, `install` for one with "install or update
+    //: Plexora" switched on. Drawing either unconditionally would promise a
+    //: wait that is never coming.
+    //:
+    //: Installing sits where it does because that is where it runs -- after
+    //: the login and before anything is launched, so that what starts
+    //: afterwards is the version it just installed.
     const STEPS = [
         { state: "connecting", label: "Reaching the machine" },
         { state: "authenticating", label: "Signing in" },
+        { state: "installing", label: "Installing Plexora", install: true },
         { state: "waiting_for_job", label: "Waiting for the scheduler",
           queued: true },
         { state: "tunneling", label: "Opening the tunnel" },
         { state: "waiting_for_app", label: "Starting Plexora" },
     ];
 
+    //: What the install step is called when the launch command names an
+    //: environment. The name comes from the server -- one reading of one field
+    //: (`connect.environment_label`), the same one `pip` will be run through
+    //: -- so a step cannot promise an environment the install does not write
+    //: to. Without a name it stays the plain label: "in undefined" would be
+    //: worse than saying nothing, and a `module load` line genuinely has no
+    //: name to give.
+    function installLabel(environment) {
+        return environment ? "Installing Plexora in " + environment
+                           : "Installing Plexora";
+    }
+
     //: What the last step is called for a data node, which does not start a
     //: viewer at all. The step list is otherwise identical because the login
     //: is identical -- same profile, same ssh, same password.
@@ -89,14 +108,23 @@ window.PlexoraConnectionModal = (function () {
      * was running -- and marking the whole list pending would throw away the
      * most useful thing on screen, which is how far it got.
      */
-    function stepStates(state, kind, queued, lastOpening) {
-        const steps = STEPS.filter((step) => !step.queued || queued);
+    function stepStates(state, kind, queued, lastOpening, install) {
+        const steps = STEPS.filter((step) => (!step.queued || queued)
+                                          && (!step.install || Boolean(install)));
         const failed = state === "failed" || state === "exited";
         const at = steps.findIndex(
             (step) => step.state === (failed ? lastOpening : state));
         return steps.map((step, index) => {
-            const label = (step.state === "waiting_for_app"
-                           && kind === "node") ? NODE_LAST_STEP : step.label;
+            let label = step.label;
+            if (step.state === "waiting_for_app" && kind === "node") {
+                label = NODE_LAST_STEP;
+            } else if (step.state === "installing") {
+                // `install` doubles as the environment's name when there is
+                // one: the caller has a profile, not two separate answers, and
+                // a second parameter that could only ever be set alongside
+                // this one is a pair that can be passed inconsistently.
+                label = installLabel(typeof install === "string" ? install : "");
+            }
             let status = "pending";
             if (state === "connected") status = "done";
             else if (at < 0) status = "pending";
@@ -323,7 +351,14 @@ window.PlexoraConnectionModal = (function () {
 
         function paintSteps(state, entry, phase, error) {
             stepsEl.replaceChildren();
-            stepStates(state, kind, entry ? entry.queued : false, lastOpening)
+            // The environment's name when the profile has one, `true` when it
+            // installs without naming one, `false` when it does not install.
+            // See stepStates: one value, because "does it install" and "into
+            // what" are one fact about one profile.
+            const installing = !entry || !entry.install ? false
+                : (entry.installEnv || true);
+            stepStates(state, kind, entry ? entry.queued : false, lastOpening,
+                       installing)
                 .forEach((step) => {
                     const item = el("li", "connect-step is-" + step.status);
                     item.append(el("span", "connect-step-mark"));
@@ -627,6 +662,36 @@ window.PlexoraConnectionModal = (function () {
                 return wrap;
             }
 
+            /**
+             * A switch, shaped so the form's own grid places it.
+             *
+             * `.connect-form` is `repeat(auto-fit, minmax(14rem, 1fr))`, so
+             * this is a cell like any other: it sits beside the box above it
+             * wherever the dialog is wide enough for two columns, and wraps
+             * under it where it is not. That is the whole of "inline when
+             * there is room" -- there is no row here to be given one.
+             */
+            function switchField(key, label, hint, initial) {
+                const wrap = el("label", "connect-field connect-switch");
+                const text = el("span", "connect-switch-text");
+                text.append(el("span", "connect-field-label", label));
+                if (hint) text.append(el("span", "connect-field-hint", hint));
+                const input = el("input", "connect-switch-input");
+                input.type = "checkbox";
+                input.checked = Boolean(initial);
+                const track = el("span", "connect-switch-track");
+                track.setAttribute("aria-hidden", "true");
+                track.append(el("span", "connect-switch-thumb"));
+                wrap.append(text, input, track);
+                // Read by the same loop that reads every text box, so the
+                // answers object stays one shape. `checked`, not `value`: the
+                // server reads this key as a boolean (recipes.compose keeps
+                // the switches out of the trim-to-string pass for exactly
+                // this reason).
+                boxes[key] = { get value() { return input.checked; } };
+                return wrap;
+            }
+
             // The three job numbers arrive FILLED IN, not as grey placeholder
             // text over an empty box. A default nobody can see is a default
             // nobody can correct, and on a multiplexed image these three are
@@ -686,6 +751,16 @@ window.PlexoraConnectionModal = (function () {
                 "Set this if a login over SSH cannot find plexora — by a wide "
                 + "margin the commonest reason a connection fails. An "
                 + "environment path is enough."));
+            // Next to the field that names the environment, because that is
+            // the environment it writes to. Off on arrival for every preset:
+            // no starting point gets to decide that software should be
+            // installed into somebody's account on a machine it has only read
+            // the documentation for.
+            advancedForm.append(switchField(
+                "install", "Install or update Plexora",
+                "Runs pip install --upgrade plexora in that environment "
+                + "before launching, and shows it in the connection log.",
+                false));
             advanced.append(advancedForm);
             parts.body.append(advanced);
 
@@ -698,7 +773,9 @@ window.PlexoraConnectionModal = (function () {
                 button("btn btn-primary", "Save and connect", async () => {
                     const answers = {};
                     Object.keys(boxes).forEach((key) => {
-                        answers[key] = boxes[key].value.trim();
+                        const value = boxes[key].value;
+                        answers[key] = typeof value === "string"
+                            ? value.trim() : value;
                     });
                     try {
                         const saved = await saveRecipe(recipe.id, answers);

{plexora-0.0.7 → plexora-0.0.8}/plexora/client/src/js/services/remoteGlobe.js

@@ -104,6 +104,15 @@ window.PlexoraRemoteGlobe = (function () {
             return { word: "Healthy", glyph: "circle-check", cls: "is-healthy",
                      ms: probe.ms, detail: "" };
         }
+        //: Its own word, because it is its own situation and the other two
+        //: would both be lies. The machine IS answering, so "Not answering" is
+        //: false; the server knows exactly what is wrong, so "Unknown" throws
+        //: that away. What is stale is the address the open project is using,
+        //: and the detail line says so and says what fixes it.
+        if (probe.state === "stale") {
+            return { word: "Reconnected", glyph: "arrows-rotate", cls: "is-degraded",
+                     ms: null, detail: probe.detail || "" };
+        }
         return {
             word: probe.state === "unreachable" ? "Not answering" : "Unknown",
             glyph: "triangle-exclamation", cls: "is-degraded", ms: null,

{plexora-0.0.7 → plexora-0.0.8}/plexora/client/src/js/services/remoteState.js

@@ -48,8 +48,8 @@ window.PlexoraRemotes = (function () {
     //: remote_sessions.OPENING_STATES. Anything not here is settled, one way
     //: or the other, and asking again would be asking a question whose answer
     //: cannot change on its own.
-    const OPENING = ["connecting", "authenticating", "waiting_for_job",
-                     "tunneling", "waiting_for_app"];
+    const OPENING = ["connecting", "authenticating", "installing",
+                     "waiting_for_job", "tunneling", "waiting_for_app"];
 
     //: What each state is called on screen. One map, because the same word has
     //: to appear on the card, in the modal's step list and in the globe's
@@ -59,6 +59,7 @@ window.PlexoraRemotes = (function () {
         idle: "Not connected",
         connecting: "Connecting",
         authenticating: "Needs your password",
+        installing: "Installing Plexora",
         waiting_for_job: "Queued",
         tunneling: "Tunnelling",
         waiting_for_app: "Starting",
@@ -214,6 +215,16 @@ window.PlexoraRemotes = (function () {
                 //: setting, and worth knowing BEFORE pressing Connect: it
                 //: turns seconds into a queue.
                 queued: remote.srun !== null && remote.srun !== undefined,
+                //: Whether connecting to this machine also installs or updates
+                //: Plexora on it, and what the environment it writes to is
+                //: called. Both from the profile, so the step list can say so
+                //: BEFORE it happens rather than after -- which for the one
+                //: step that writes to somebody else's machine is the
+                //: difference between a plan and a surprise. `installEnv` is a
+                //: display name and may be null even when `install` is on: not
+                //: every launch command names an environment anything.
+                install: Boolean(remote.install),
+                installEnv: remote.install_env || null,
                 viewer: viewer,
                 node: node,
                 //: Either half up is "this machine is reachable" for the

{plexora-0.0.7 → plexora-0.0.8}/plexora/client/src/js/views/settingsPage.js

@@ -814,8 +814,15 @@
         card.chip.className = "settings-node-state is-" + state;
         card.chip.textContent = window.PlexoraRemotes.label(state);
 
+        // On the address line rather than as a badge of its own: these are
+        // both "what pressing Connect will do to that machine before you see
+        // anything", and the install one is the half that writes.
         card.address.textContent = entry.detail
-            + (entry.queued ? "  ·  runs inside a job" : "");
+            + (entry.queued ? "  ·  runs inside a job" : "")
+            + (entry.install
+                ? "  ·  installs Plexora"
+                  + (entry.installEnv ? " in " + entry.installEnv : "")
+                : "");
 
         card.phase.textContent = half.phase || "";
         card.phase.hidden = !half.phase;
@@ -1144,6 +1151,8 @@
         this.revealJob(scheduler);
         const bind = el("settings_remote_bind_node");
         if (bind) bind.checked = !!remote.bind_node;
+        const install = el("settings_remote_install");
+        if (install) install.checked = !!remote.install;
 
         this.forwards = (remote.forwards || []).map(String);
         this.renderForwards();
@@ -1152,7 +1161,12 @@
         // empty disclosure on every Edit makes the form look like it has nine
         // questions when this server answered three of them.
         const advanced = el("settings_remote_advanced");
+        // `install` counts here for a reason the others do not have: it is the
+        // one setting in this form that makes connecting WRITE to the far
+        // machine, so an Edit that hid it would be hiding the answer somebody
+        // is most likely to have come to change.
         if (advanced) advanced.open = scheduler || this.forwards.length > 0
+            || Boolean(remote.install)
             || Boolean(remote.remote_command
                        && remote.remote_command !== "plexora");
         text(el("settings_remote_form_title"), "Edit “" + remote.name + "”");
@@ -1166,7 +1180,8 @@
             setValue(REMOTE_FIELDS[key], "");
         });
         setValue("settings_remote_port", "");
-        ["settings_remote_use_srun", "settings_remote_bind_node"].forEach((id) => {
+        ["settings_remote_use_srun", "settings_remote_bind_node",
+         "settings_remote_install"].forEach((id) => {
             const box = el(id);
             if (box) box.checked = false;
         });
@@ -1188,6 +1203,7 @@
         });
         body.use_srun = !!(el("settings_remote_use_srun") || {}).checked;
         body.bind_node = !!(el("settings_remote_bind_node") || {}).checked;
+        body.install = !!(el("settings_remote_install") || {}).checked;
         body.forwards = this.forwards.slice();
 
         const button = el("settings_remote_save");

{plexora-0.0.7 → plexora-0.0.8}/plexora/client/templates/base.html

@@ -8,7 +8,7 @@
     <link rel="apple-touch-icon" href="{{ data.base_url }}/client/src/img/apple-touch-icon.png">
     <!-- Styles -->
     <link rel="stylesheet" href="{{ data.base_url }}/client/src/css/tokens.css?v=20260829_view_palette">
-    <link rel="stylesheet" href="{{ data.base_url }}/client/src/css/main.css?v=20260829_channel_names_switch">
+    <link rel="stylesheet" href="{{ data.base_url }}/client/src/css/main.css?v=20260830_install_plexora">
     {% block style %}{% endblock %}
 
 
@@ -87,17 +87,17 @@
        the one poll that four surfaces used to run three of. It costs nothing
        on a page that never subscribes -- there is no timer until somebody
        does. #}
-    <script src="{{ data.base_url }}/client/src/js/services/remoteState.js?v=20260829_gone_node" defer></script>
+    <script src="{{ data.base_url }}/client/src/js/services/remoteState.js?v=20260830_install_plexora" defer></script>
     {# The connection log, shared by the modal and the Settings page's cards.
        Before both of them: they call into it as they build. #}
     <script src="{{ data.base_url }}/client/src/js/services/logTerminal.js?v=20260829_terminal" defer></script>
-    <script src="{{ data.base_url }}/client/src/js/services/connectionModal.js?v=20260829_add_server3" defer></script>
+    <script src="{{ data.base_url }}/client/src/js/services/connectionModal.js?v=20260830_install_plexora" defer></script>
     <script src="{{ data.base_url }}/client/src/js/services/placePicker.js?v=20260828_connect_modal" defer></script>
     {# The navbar's connection icon. Deferred like the rest, which still runs
        it after pageBoot.js below (a normal script beats every deferred one),
        so PlexoraPage.register exists by the time this file's last line runs.
        It needs popoverPortal.js, loaded above with the other widgets. #}
-    <script src="{{ data.base_url }}/client/src/js/services/remoteGlobe.js?v=20260829_job_clock" defer></script>
+    <script src="{{ data.base_url }}/client/src/js/services/remoteGlobe.js?v=20260830_node_reconnect" defer></script>
     {# Says so before a scheduled job ends, from whichever page the user is on.
        After connectionModal.js, which its one button opens; passive, so it
        costs nothing while a connection sits settled. #}

{plexora-0.0.7 → plexora-0.0.8}/plexora/client/templates/settings.html

@@ -1,6 +1,6 @@
 {% extends layout|default('base.html', true) %}
 {% block style %}
-    <link rel="stylesheet" href="{{ data.base_url }}/client/src/css/settings.css?v=20260829_job_clock">
+    <link rel="stylesheet" href="{{ data.base_url }}/client/src/css/settings.css?v=20260830_install_plexora">
 {% endblock %}
 {% block content %}
 <title>Plexora - Settings</title>
@@ -281,7 +281,24 @@
                         <summary class="remote-advanced-summary">Advanced options</summary>
 
                         <div class="remote-group">
-                            <div class="remote-group-title">Plexora environment</div>
+                            {# The switch rides the group's own title row
+                               rather than taking a row of its own: it is the
+                               same question as the box below it -- which
+                               environment -- asked as "and keep Plexora
+                               current in it". A dedicated row would put an
+                               uppercase section label and a lone toggle on two
+                               lines that both say "environment". #}
+                            <div class="remote-group-head">
+                                <div class="remote-group-title">Plexora environment</div>
+                                <label class="remote-switch remote-switch-inline">
+                                    <span class="remote-switch-label">Install or update Plexora</span>
+                                    <input type="checkbox" id="settings_remote_install"
+                                           class="remote-switch-input">
+                                    <span class="remote-switch-track" aria-hidden="true">
+                                        <span class="remote-switch-thumb"></span>
+                                    </span>
+                                </label>
+                            </div>
                             <div class="remote-form">
                                 <label class="remote-field">
                                     <span class="remote-label">Plexora command or environment</span>
@@ -290,7 +307,12 @@
                                            placeholder="plexora" autocomplete="off">
                                     <span class="remote-hint">
                                         If SSH cannot find Plexora, specify its
-                                        environment or launch command.
+                                        environment or launch command. With
+                                        <strong>Install or update Plexora</strong>
+                                        on, connecting runs
+                                        <code>pip install --upgrade plexora</code>
+                                        in this same environment first, and shows
+                                        the whole of it in the connection log.
                                     </span>
                                 </label>
                                 {# The examples are behind a disclosure because
@@ -541,5 +563,5 @@
 {# remoteState.js is loaded by base.html, above and deferred, so it is parsed
    before this file runs -- the Remote servers section is one of its
    subscribers rather than a poller of its own. #}
-<script src="{{ data.base_url }}/client/src/js/views/settingsPage.js?v=20260829_job_clock" defer></script>
+<script src="{{ data.base_url }}/client/src/js/views/settingsPage.js?v=20260830_install_plexora" defer></script>
 {% endblock %}