Download and install
Pick the line for your system. Every installer downloads from the official WECOMMANDER release, verifies the SHA-256 checksum against the published SHA256SUMS.txt, and refuses to install when it does not match.
Which package do I need?
| System | What you install | Command or source |
|---|---|---|
| Windows 10/11 (x64), desktop | The WECOMMANDER app with the agent inside (per user, no administrator rights) | irm https://wecommander.app/install.ps1 | iex, or the download button on the Download page |
| Windows, Microsoft Store | The same app, packaged for the Store; updates come from the Store | Microsoft Store product ID 9P66C88PSBP6 |
| macOS 13 or newer (Apple Silicon or Intel) | WECOMMANDER Center.app with the agent inside (current user, no password) | curl -fsSL https://wecommander.app/install.sh | sh |
| Linux server (Ubuntu or Debian, amd64, systemd) | The agent as a Debian package and systemd service | curl -fsSL https://wecommander.app/install.sh | sh |
| Windows server without a desktop | The agent alone with the Windows setup (asks for administrator approval once) | irm https://wecommander.app/install/agent.ps1 | iex |
| Linux desktop (x86_64, WebKitGTK 4.1) | The Linux Management Center: approvals, devices and SSH servers shared with AI | curl -fsSL https://wecommander.app/install/center.sh | sh |
Windows
- Open PowerShell (no administrator window needed) and run the command below, or download the installer from the Download page in the dashboard and double-click it. If Windows asks, choose “Run anyway”.
- The app starts and opens your browser to sign in. Sign in with your WECOMMANDER account and approve this computer.
- This computer connects by itself; the agent runs in the background inside the app. The shared folder for AI is C:\Users\<you>\WECOMMANDER unless you choose another.
irm https://wecommander.app/install.ps1 | iexThe app installs for your Windows user only and starts with Windows. It keeps the agent running and restarts it if it stops; if it cannot, it tries again every 5 minutes. Quitting the app from the tray icon stops the agent too, so AI cannot reach this computer until the app runs again.
Microsoft Store
The Windows app is also packaged for the Microsoft Store (product ID 9P66C88PSBP6). The Store copy updates through the Store and starts with Windows through its startup task; otherwise it is the same app. Its settings say “updates come from the Microsoft Store” instead of offering the in-app update.
macOS
curl -fsSL https://wecommander.app/install.sh | shOn a Mac the command installs WECOMMANDER Center.app into ~/Applications for the current user and opens it; no administrator password is asked. The app signs in through the browser, pairs this Mac by itself, runs the agent in the background and opens at login. The default folder shared with AI is ~/WECOMMANDER. To see what would be installed without installing, use the dry-run form:
curl -fsSL https://wecommander.app/install/center.sh | sh -s -- --dry-runLinux servers
curl -fsSL https://wecommander.app/install.sh | sh- The command asks for sudo itself. It installs the wecommander-agent package with apt, creates an unprivileged wecommander system user and starts the webrising-commender systemd service.
- It prints a link such as https://wecommander.app/connect-device?requestId=…. Open it on your own computer, sign in, choose the workspace and approve the server. Never type your account password into the server's terminal.
- The default allowed folder is /var/lib/webrising-commender/workspace. The service runs as wecommander, without sudo, Docker group membership or root.
- To install the package without linking it yet, add --package-only and run sudo wecommander-setup later.
# Install now, link later
curl -fsSL https://wecommander.app/install.sh | sh -s -- --package-only
sudo wecommander-setup
# Read the installer first (recommended on production servers)
curl -fsSLo /tmp/wecommander-install.sh https://wecommander.app/install/ubuntu.sh
less /tmp/wecommander-install.sh
sudo bash /tmp/wecommander-install.sh --control-url https://wecommander.appFlags for the allowed folder, read-only mode, no commands and running as root are described on Agent: install, update and options.
Windows servers without a desktop
irm https://wecommander.app/install/agent.ps1 | iexThis installs the agent alone with the WECOMMANDER setup program; Windows asks for administrator approval for the setup (never for your Windows password). The agent then runs as the signed-in Windows user with that user's rights, through a per-user scheduled task. It runs only while that user is signed in; it does not start before Windows sign-in.
Linux desktops
curl -fsSL https://wecommander.app/install/center.sh | shThis installs the Linux Management Center for the current user into ~/.local/share/wecommander-center with a menu entry. It is not the full desktop SSH client (there are no terminal tabs or SFTP on Linux yet); see Linux Management Center for what it does.
Updates
- Windows app: a notice appears when a new version is out; choose Update in the app. The package is checked against SHA256SUMS.txt before it replaces the app, and the app restarts. The Store copy updates through the Store.
- macOS app: when a new version is out, choose Update app in the panel; the app reinstalls itself and reopens in a few seconds. Running the install command again also installs the newest release.
- Linux agent: run the install command again. The existing device identity is kept, so the server stays the same device in your dashboard.
- After an update the desktop apps show a short what's-new note once. Every note is also on https://wecommander.app/changelog.
Uninstall
- Windows: remove WECOMMANDER in Settings → Apps → Installed apps. Revoke the device in the dashboard (Devices) when you retire the computer.
- Linux server: sudo bash /opt/wecommander/libexec/uninstall-linux.sh stops and removes the service and the run-as-root rule; the binary and the agent config are kept. Revoke the device in the dashboard.
- Agent: install, update and options: The WECOMMANDER agent on Windows, macOS and Linux: how it is installed and updated, the user it runs as, allowed folders, read-only and no-command switches, --allow-root, and checking its status.
- The desktop app at a glance: What the WECOMMANDER desktop app does on Windows and macOS, what the Linux Management Center covers, first-launch tutorial, languages and updates.
- Linux Management Center: The WECOMMANDER Management Center for Linux desktops: approvals, autonomous mode, devices, sharing SSH servers with remote AI, and what it does not do yet.
- Troubleshooting: Fixes for common problems: agent offline, host key changed, approval not arriving, SSH server unreachable for AI, root not available, commands refused, updates and plan limits.
Install WECOMMANDER on a Linux server
- On the server run: curl -fsSL https://wecommander.app/install.sh | sh
- Open the connect-device link the installer prints on your own computer and sign in.
- Choose the workspace and approve the server.
- Check that the device shows Online under Devices in the dashboard.