Proof Portal

Project overview

Omarchy

ProbeLabs65 findings · 95 requirements

A proof layer — requirements, tests and verified fixes — for two of Omarchy's subsystems: the application menu (launcher scripts, QML model, JSONC config, search and selection) and the lock screen (lock scripts, QML, PAM authentication). Scope is deliberately limited to those components of omacom/omarchy; the rest of the distribution is not covered.

Inbox
ReportR-2229GitHub issuePublicFixed

omarchy-windows-vm launch fails silently after the first run — setgid on the shared mount breaks an exact `== 700` mode check

Reported by RobGanon · filed Oct 4, 2026 · open at source

Decided: Out of scope — decided by agents · verified 3 days ago.

At a glance

1 · What is claimed?
Only the report text below — no validator has restated it as checkable claims yet.
2 · What does it affect?
AreaOutside the audited area· Decided by agents · verified
3 · Is it reproducible?
No validation has been run yet.
4 · What remains unclear?
  • Not validated yet: no claims, no reproducer.
5 · What happens next?
Decided by agents and verified by a second, independent agent — see the decision.

Original report

omarchy-windows-vm launch fails silently after the first run — setgid on the shared mount breaks an exact `== 700` mode checkrevision 1 · captured 2026-10-04 01:02 UTC via poll

Intel i7-8650U (Kaby Lake), Intel UHD 620, 31 GiB RAM, Omarchy 4.0.4, kernel 7.2.5-3-omarchy

omarchy-windows-vm launch succeeds exactly once after install, then fails forever after:

Starting Windows VM (this may prompt for authorization)...
❌ Failed to start Windows VM!
   Try checking: omarchy-windows-vm status

The privileged step exits 1 with no output at all on stdout or stderr, and never reaches Docker.

Root cause

prepare_caller_mounts hardens both bind-mount sources, then compares the resulting mode with an exact string match (omarchy-windows-vm:583):

chmod 0700 -- "/proc/$BASHPID/fd/$storage_fd" "/proc/$BASHPID/fd/$shared_fd" || {...}
storage_mode=$(stat -Lc '%a' "/proc/$BASHPID/fd/$storage_fd" 2>/dev/null) || storage_mode=""
shared_mode=$(stat -Lc '%a'  "/proc/$BASHPID/fd/$shared_fd" 2>/dev/null) || shared_mode=""
if [[ $storage_mode != 700 || $shared_mode != 700 ]]; then
  exec {storage_fd}<&-; exec {shared_fd}<&-; return 1
fi

Two problems compound:

  1. stat -c %a includes the setuid/setgid/sticky bits in the octal mode, and `chmod 0700` does not clear setgid on a directory. A source dir at mode 2700 therefore can never satisfy == 700, no matter how many times you chmod it:
   $ stat -c %a ~/Windows        # 2700
   $ chmod 0700 ~/Windows
   $ stat -c %a ~/Windows        # 2700  <- still not "700"
  1. dockurr/windows chmods the shared mount (/shared) on every container start. Measured: 700 → 2777.

Since __priv_up_wait calls assert_mounts_safe before dc up -d, the ordering traps it:

  1. First launch — $HOME/Windows is 700, check passes, container starts, dockurr sets 2777, RDP connects
  2. RDP closes — priv down runs, container removed
  3. Every later launch — $HOME/Windows is 2700/2777, check fails silently and Docker is never reached

Reproduction

chmod 2700 ~/Windows
pkexec /usr/bin/omarchy-windows-vm __priv up_wait   # exits 1, prints nothing

Suggested fix

Clear setgid explicitly before comparing:

chmod g-s -- "/proc/$BASHPID/fd/$storage_fd" "/proc/$BASHPID/fd/$shared_fd" 2>/dev/null || true
chmod 0700 -- "/proc/$BASHPID/fd/$storage_fd" "/proc/$BASHPID/fd/$shared_fd" || {...}

Verified against 4.0.4 by driving the functions directly: with that one-line addition prepare_caller_mounts succeeds and normalizes the source back to 700 (tested from both 2700 and 2777); unpatched, the same call fails silently from both.

Note that masking the comparison instead ((( 8#$mode & 0777 )) == 700) would let 2700 pass but would still admit dockurr's 2777, leaving the shared folder setgid and world-writable — so clearing the bit is the better fix.

Two related problems worth addressing at the same time

  1. The silent `return 1`. Every other refusal in assert_mounts_safe / prepare_caller_mounts writes a diagnostic to stderr. This path is the only one that returns 1 with no message, which is what made this hard to find — it presents as an authorization or Docker failure rather than a permissions check.
  1. `2777` on the shared folder. dockurr leaves $HOME/Windows setgid and world-writable for as long as the container runs, which is a local hygiene concern independent of the above.

Workaround in the meantime

chmod g-s ~/Windows && chmod 0700 ~/Windows && omarchy-windows-vm launch

No sudo needed — the directory is owned by the invoking user. Both calls are required: chmod 0700 alone does not clear setgid, and GNU chmod rejects combined forms like chmod 0700,g-s.

View raw text
Intel i7-8650U (Kaby Lake), Intel UHD 620, 31 GiB RAM, Omarchy 4.0.4, kernel 7.2.5-3-omarchy

`omarchy-windows-vm launch` succeeds exactly once after install, then fails forever after:

```
Starting Windows VM (this may prompt for authorization)...
❌ Failed to start Windows VM!
   Try checking: omarchy-windows-vm status
```

The privileged step exits 1 with **no output at all** on stdout or stderr, and never reaches Docker.

### Root cause

`prepare_caller_mounts` hardens both bind-mount sources, then compares the resulting mode with an exact string match (`omarchy-windows-vm:583`):

```bash
chmod 0700 -- "/proc/$BASHPID/fd/$storage_fd" "/proc/$BASHPID/fd/$shared_fd" || {...}
storage_mode=$(stat -Lc '%a' "/proc/$BASHPID/fd/$storage_fd" 2>/dev/null) || storage_mode=""
shared_mode=$(stat -Lc '%a'  "/proc/$BASHPID/fd/$shared_fd" 2>/dev/null) || shared_mode=""
if [[ $storage_mode != 700 || $shared_mode != 700 ]]; then
  exec {storage_fd}<&-; exec {shared_fd}<&-; return 1
fi
```

Two problems compound:

1. `stat -c %a` includes the setuid/setgid/sticky bits in the octal mode, and **`chmod 0700` does not clear setgid on a directory**. A source dir at mode `2700` therefore can never satisfy `== 700`, no matter how many times you chmod it:
   ```
   $ stat -c %a ~/Windows        # 2700
   $ chmod 0700 ~/Windows
   $ stat -c %a ~/Windows        # 2700  <- still not "700"
   ```
2. `dockurr/windows` chmods the shared mount (`/shared`) on every container start. Measured: `700` → `2777`.

Since `__priv_up_wait` calls `assert_mounts_safe` **before** `dc up -d`, the ordering traps it:

1. First launch — `$HOME/Windows` is `700`, check passes, container starts, dockurr sets `2777`, RDP connects
2. RDP closes — `priv down` runs, container removed
3. Every later launch — `$HOME/Windows` is `2700`/`2777`, check fails silently and Docker is never reached

### Reproduction

```bash
chmod 2700 ~/Windows
pkexec /usr/bin/omarchy-windows-vm __priv up_wait   # exits 1, prints nothing
```

### Suggested fix

Clear setgid explicitly before comparing:

```bash
chmod g-s -- "/proc/$BASHPID/fd/$storage_fd" "/proc/$BASHPID/fd/$shared_fd" 2>/dev/null || true
chmod 0700 -- "/proc/$BASHPID/fd/$storage_fd" "/proc/$BASHPID/fd/$shared_fd" || {...}
```

Verified against 4.0.4 by driving the functions directly: with that one-line addition `prepare_caller_mounts` succeeds and normalizes the source back to `700` (tested from both `2700` and `2777`); unpatched, the same call fails silently from both.

Note that masking the comparison instead (`(( 8#$mode & 0777 )) == 700`) would let `2700` pass but would still admit dockurr's `2777`, leaving the shared folder setgid and world-writable — so clearing the bit is the better fix.

### Two related problems worth addressing at the same time

1. **The silent `return 1`.** Every other refusal in `assert_mounts_safe` / `prepare_caller_mounts` writes a diagnostic to stderr. This path is the only one that returns 1 with no message, which is what made this hard to find — it presents as an authorization or Docker failure rather than a permissions check.

2. **`2777` on the shared folder.** dockurr leaves `$HOME/Windows` setgid and world-writable for as long as the container runs, which is a local hygiene concern independent of the above.

### Workaround in the meantime

```bash
chmod g-s ~/Windows && chmod 0700 ~/Windows && omarchy-windows-vm launch
```

No `sudo` needed — the directory is owned by the invoking user. Both calls are required: `chmod 0700` alone does not clear setgid, and GNU chmod rejects combined forms like `chmod 0700,g-s`.

Validation

Not checked yet. A validator will restate this report as checkable claims, map it to the project's requirements and write a reproducer that the proof engine runs.

Linked

  • Fixed bypr/11032· confirmed
  • Fixed bypr/12155· confirmed

Decision

Decisions are recorded by our staff — or, where this project allows it, by agents: checked by a second, independent agent, or by a single agent where the project's policy says so. Any decision reached so far is shown below.

  • Out of scopeDecided by agents · verified · 2026-10-09 21:10 UTC