Skip to content

RSDK-14255: Remove AppImage/manual install-method step for 64-bit Linux setup#5202

Draft
Ale Paredes (ale7714) wants to merge 1 commit into
mainfrom
docs/rsdk-14255-appimage-64bit-setup
Draft

RSDK-14255: Remove AppImage/manual install-method step for 64-bit Linux setup#5202
Ale Paredes (ale7714) wants to merge 1 commit into
mainfrom
docs/rsdk-14255-appimage-64bit-setup

Conversation

@ale7714

@ale7714 Ale Paredes (ale7714) commented Jul 14, 2026

Copy link
Copy Markdown
Member

What

Updates the Linux setup instructions to match viamrobotics/app#12758 (RSDK-14255), which removes the AppImage ("manual") install option for the two 64-bit Linux platforms (Linux / Aarch64 and Linux / x86_64) on the machine setup page. viam-agent is now the only, forced install path for those platforms.

After that change, every platform in the setup UI has exactly one install option (aarch64/x86_64 → viam-agent; armv7l/Mac/Windows → manual), so the "Installation method" dropdown no longer renders for anyone. The docs still instructed users to pick viam-agent vs. manual for 64-bit Linux, which no longer exists.

Changes

  • static/include/install/install-linux.md — removed the "also select your installation method (viam-agent / manual)" sub-step; now states that Viam installs viam-agent for Aarch64 and x86_64. (Also drops the stale Aarch 64/x86 typos.)
  • static/include/install/install-linux-aarch.md — removed the "Select your installation method" step; Aarch64 now installs viam-agent directly.

Both files render on the "Set up a computer or SBC" install flow and in device-setup guides that readfile these includes.

Deliberately NOT changed (flagging for review)

  • docs/reference/viam-server.md — the "Install viam-server without the web UI" section still documents an "Install manually" AppImage tab for Linux (Aarch64/x86_64). app#12758 is frontend-only and the manual curl … --aix-install CLI path still works (RDK still builds/publishes AppImages), so these are intentionally left. They should be revisited when the RDK-side AppImage build/publish is removed.
  • static/include/install/architectures.md — the AppImage curl … --aix-install snippet for 64-bit; now unreachable from the setup flow but still valid for the CLI path / Armv7l. Left for the same follow-up.
  • docs/monitor/common-errors.md (FUSE / libfuse.so.2) and the aarch64 device-setup guides' AppImage wget fallbacks — still relevant while AppImage exists for Armv7l and the manual CLI path; part of the broader AppImage-deprecation cleanup, not this step.

Scope

64-bit Linux setup instructions only. Armv7l (32-bit ARM), Mac, Windows, and WSL are untouched.

🤖 Generated with Claude Code

viam-agent is now the only install option for Linux/Aarch64 and
Linux/x86_64 on the machine setup page (see viamrobotics/app#12758,
RSDK-14255). The "Installation method" selector no longer renders for
any platform, so drop the obsolete viam-agent-vs-manual choice from the
Linux setup includes. Armv7l, Mac, and Windows are unaffected.
@netlify

netlify Bot commented Jul 14, 2026

Copy link
Copy Markdown

Deploy Preview for viam-docs ready!

Name Link
🔨 Latest commit bab60d9
🔍 Latest deploy log https://app.netlify.com/projects/viam-docs/deploys/6a56896674449c0009c9334d
😎 Deploy Preview https://deploy-preview-5202--viam-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 44 (🟢 up 4 from production)
Accessibility: 100 (no change from production)
Best Practices: 100 (no change from production)
SEO: 92 (no change from production)
PWA: 60 (no change from production)
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@viambot viambot added the safe to build This pull request is marked safe to build from a trusted zone label Jul 14, 2026
@btshrewsbury-viam

btshrewsbury-viam commented Jul 14, 2026

Copy link
Copy Markdown
Collaborator

Hold merging this until viamrobotics/app#12758 merges and deploys

@ale7714
Ale Paredes (ale7714) marked this pull request as draft July 15, 2026 17:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

safe to build This pull request is marked safe to build from a trusted zone

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants