Skip to content
TraceWall Desktop V3 AI

Linux Desktop Installation

Download the Linux installer exclusively from https://download.trace-wall.com/. Verify the version, SHA-256 checksum, and signature status before installing.

Supported Distributions

DistributionVariantStatus
Ubuntu 22.04 LTSDesktop (GNOME)✅ Tested
Ubuntu 24.04 LTSDesktop (GNOME)✅ Tested
Debian 12 (Bookworm)Desktop (GNOME/KDE/XFCE)✅ Tested

Only desktop variants with a graphical environment are supported. Server/minimal installs without X11/Wayland are not compatible with the current Desktop package.

Prerequisites

  • Architecture: amd64 (x64) only — ARM64 not currently published
  • Graphical environment: X11 or Wayland (GNOME, KDE Plasma, XFCE tested)
  • RAM: 8 GB minimum (16 GB recommended for ARGUS)
  • Disk: 2 GB free for application + logs + telemetry
  • Dependencies: Included in .deb (libnss3, libatk1.0-0, libdrm2, libgbm1, libasound2, etc.)
  • Network: LAN access to managed infrastructure; internet for ARGUS model download (first run)

Pre-Install Verification

  1. Confirm the download source: https://download.trace-wall.com/ (TLS valid, no redirects)

  2. Note the published metadata: version, file size, SHA-256 checksum

  3. Download the package (.deb)

  4. Verify the checksum:

    Terminal window
    sha256sum TraceWall-Desktop-V3-x.x.x_amd64.deb
    # or
    shasum -a 256 TraceWall-Desktop-V3-x.x.x_amd64.deb

  5. Compare character-by-character with the published checksum.

  6. If mismatch: delete, re-download, re-verify. If persistent, contact support.

Installation

Terminal window
sudo apt install ./TraceWall-Desktop-V3-x.x.x_amd64.deb

The package:

  • Installs to /opt/tracewall
  • Creates /usr/bin/tracewall symlink
  • Adds .desktop entry for application menu
  • Configures systemd user service for background sensor (optional)

Post-Install Verification

  1. Launch TraceWall from application menu or run tracewall in terminal.
  2. Local Sensor panel should show:
    • Hostname, OS, uptime
    • Network interfaces (via AF_PACKET sockets)
    • CPU, memory, disk utilization
  3. Settings → About — confirm version matches downloaded release.
  4. Settings → Sensor — confirm “Local telemetry” is Enabled.

ARGUS Local AI

  • First launch downloads the GGUF model (~4–8 GB) if not bundled
  • Runs entirely locally via loopback (127.0.0.1:<port>)
  • Requires AVX2 CPU; NVIDIA GPU (CUDA, 8+ GB VRAM) optional for acceleration
  • No model weights or prompts leave the machine

Updating

Terminal window
sudo apt install ./TraceWall-Desktop-V3-x.x.x-new_amd64.deb

Read release notes and verify checksum before upgrading.

Uninstalling

Terminal window
sudo apt remove tracewall-desktop

Removes application and systemd user unit. User data preserved in ~/.local/share/tracewall/.

To purge all data:

Terminal window
sudo apt purge tracewall-desktop
rm -rf ~/.local/share/tracewall ~/.config/tracewall

Troubleshooting

SymptomLikely CauseResolution
dpkg dependency errorsMissing dependenciesRun sudo apt -f install
App won’t launch (Wayland)Electron Wayland flagsTry tracewall --enable-features=WaylandWindowDecorations
Sensor shows no interfacesPermissionsEnsure user in no special group needed; AF_PACKET works unprivileged
ARGUS model download failsNo internet / disk spaceEnsure internet access, 8+ GB free in ~/.local/share/tracewall/models/
High CPU on idleSensor polling intervalAdjust in Settings → Sensor → Polling interval

Package Inspection (Optional)

Terminal window
# Show package metadata
dpkg -I TraceWall-Desktop-V3-x.x.x_amd64.deb


# List contents without extracting
dpkg -c TraceWall-Desktop-V3-x.x.x_amd64.deb


# Verify embedded checksums (if provided in DEBIAN/md5sums or DEBIAN/sha256sums)
dpkg-sig --verify TraceWall-Desktop-V3-x.x.x_amd64.deb

The .deb is not currently PGP-signed. Verification relies on SHA-256 from the official download page.