From 5b8a93d808c6561824f4e1e6b9230c22ee2768b0 Mon Sep 17 00:00:00 2001
From: Henrik Till Lemke <lemke_h@saresb-cons-03.psi.ch>
Date: Thu, 15 Oct 2026 13:06:36 +0200
Subject: [PATCH] setup-network-drives: link PSI's mount tool into bin,
 document it

Run it first when ~/network_drives/home is missing (gopass not
initialized, firefox_shared_profile creating a fresh empty profile).
---
 cheatsheet.md        | 1 +
 cheatsheet_admin.md  | 4 ++++
 list_bin_commands    | 1 +
 setup-network-drives | 1 +
 4 files changed, 7 insertions(+)
 create mode 120000 setup-network-drives

diff --git a/cheatsheet.md b/cheatsheet.md
index 2a817f6..3dd3e81 100644
--- a/cheatsheet.md
+++ b/cheatsheet.md
@@ -335,6 +335,7 @@ Every script in `/sf/bernina/bin`, grouped by topic. Generated by `list_bin_comm
 | `kerberos_ticket_renew` | Keep the Kerberos ticket cache alive for the login session (runs in background) |
 | `migrate_to_network_drive` | Move a local dotfile onto PSI's Partially Shared Home and register it for sync |
 | `set_gnome_keyboard_shortcut` | Register one GNOME custom keyboard shortcut (used by startup_bernina_terminal) |
+| `setup-network-drives` | Mount ~/network_drives (PSI home etc.) now, running kinit first if needed -- run this first when gopass/shared Firefox profile/home links fail (link to PSI's /usr/local/bin/setup-network-drives) |
 | `startup_bernina_terminal` | Full per-login setup for a Bernina console -- runs automatically at login |
 | `sync_personal_config` | Seed .ipython/.condarc onto PSI's Partially Shared Home for cross-host sync |
 
diff --git a/cheatsheet_admin.md b/cheatsheet_admin.md
index 16c042c..74a1b3e 100644
--- a/cheatsheet_admin.md
+++ b/cheatsheet_admin.md
@@ -9,10 +9,14 @@ operation shortcuts, which live in the
 | Command | Description |
 |---|---|
 | `create_personal_dir` | Create/verify a personal working directory under `/sf/bernina/config/personal/<username>` |
+| `setup-network-drives` | Mount `~/network_drives` (PSI home, group shares) now; asks for `kinit` if there is no Kerberos ticket. Run it first, in a terminal, when the network home is missing (gopass "not initialized", new empty Firefox shared profile, dangling `~/.ssh` links). PSI-provided, linked here from `/usr/local/bin` |
 | `create-links-in-home` | Force-apply PSI's Partially Shared Home symlinks now (normally applied automatically at login) |
 | `migrate_to_network_drive` | Move a local dotfile onto PSI's Partially Shared Home and register it for sync across hosts |
 | `sync_personal_config` | Seed `.ipython`/`.condarc` onto PSI's Partially Shared Home for cross-host sync |
 
+If `~/network_drives/home` is a plain directory instead of a link, something wrote there before the mount finished; `setup-network-drives` can't fix that by itself. Close what uses it, then
+`mv ~/network_drives/home ~/network_drives/home.broken && setup-network-drives`.
+
 ## gopass secrets
 
 | Command | Description |
diff --git a/list_bin_commands b/list_bin_commands
index c0cb3eb..bb319b9 100755
--- a/list_bin_commands
+++ b/list_bin_commands
@@ -190,6 +190,7 @@ COMMANDS = {
 
     # --- Login session & keybinding setup ---
     "create-links-in-home": ("Login session & keybinding setup", "Force-apply PSI's Partially Shared Home symlinks now"),
+    "setup-network-drives": ("Login session & keybinding setup", "Mount ~/network_drives (PSI home etc.) now, running kinit first if needed -- run this first when gopass/shared Firefox profile/home links fail (link to PSI's /usr/local/bin/setup-network-drives)"),
     "gogh": ("Login session & keybinding setup", "Gogh terminal color-scheme installer (legacy -- upstream download is broken, see install_terminal_profiles)"),
     "install_terminal_profiles": ("Login session & keybinding setup", "Install Solarized/Spacedust GNOME Terminal profiles, set Spacedust default (runs at login)"),
     "kerberos_ticket_renew": ("Login session & keybinding setup", "Keep the Kerberos ticket cache alive for the login session (runs in background)"),
diff --git a/setup-network-drives b/setup-network-drives
new file mode 120000
index 0000000..f68f2ab
--- /dev/null
+++ b/setup-network-drives
@@ -0,0 +1 @@
+/usr/local/bin/setup-network-drives
\ No newline at end of file