Appendix: Issues Encountered

Issues Encountered

Phase Issue Resolution

0

Play Store Termux is deprecated and broken

Install from F-Droid only

1

Too many auth failures with 6 identity files in SSH config

Use sudo scp -o PubkeyAuthentication=no for initial key transfer

2

Vault role missing new Termux user after reinstall (u0_a361 → u0_a385)

vault write ssh/roles/domus-client with updated allowed_users

2

vault-ssh-sign script hardcodes principals with old user

Manual workaround: vault write with correct principals. Script needs updating.

2

Vault SSH cert expires after 8 hours (TTL)

Re-sign daily. Morning SSH failures are expired certs, not broken config.

2

Tilde (~) does not expand in Vault @ file syntax

Use $HOME instead: public_key=@$HOME/.ssh/…​

4

GPG error: invalid item 'BZIP2' in preference string

sed -i 's/ BZIP2//g' ~/.gnupg/gpg.conf — BZIP2 not supported in Termux

4

GPG error: database_open waiting for lock

Remove stale lock files: rm -f ~/.gnupg/public-keys.d/.lock ~/.gnupg/.#

4

gopass manual config edit breaks store

Use gopass mounts add command — never edit config file directly

5

.zshenv fails: no such file or directory: .cargo/env

Make cargo sourcing conditional: [[ -f "$HOME/.cargo/env" ]] && . "$HOME/.cargo/env"

5

stow --adopt overwrites dotfiles with target’s files

Never use --adopt on new machines. Remove conflicts first, then stow.

5

Synced x86_64 binaries (oh-my-posh) crash on ARM64

Remove and reinstall via pkg for native ARM64 binaries

6

Mason (Neovim LSP installer) broken on Termux — no Android binaries

Install LSPs directly via pkg/npm. Use nvim 0.11 native LSP API fallback.

6

blink.cmp requires Rust build on ARM64

pkg install rust binutils make clang then cargo build --release

7

Oh-my-posh crashes on ARM64 Termux (Go runtime panic in writeSegmentsConcurrently)

Use Starship instead (Rust-based, stable on ARM64). All oh-my-posh themes crash.

8

Clipboard commands hang forever with no error

Must install BOTH pkg install termux-api AND the Termux:API Android app from F-Droid

 — 

Full reinstall required (2026-03-17)

gopass + SSH stopped working. Clean reinstall from F-Droid resolved all issues. INC-2026-03-16