# Install AERIS OS by E:MERGENCE — agent runbook This file is for AI agents asked to "install AERIS OS by E:mergence from emergencerising.com/aerisOS". It is plain Markdown; follow the steps in order. Human page: https://www.emergencerising.com/aerisOS Current release (from the published channel manifests): | Platform | Version | File | Size | sha256 | |---|---|---|---|---| | Linux x86_64 (.deb) | 0.2.50 | AERIS-OS-0.2.50-amd64.deb | 88,994,996 bytes | 5dcb91ca66b89ba93da620b901505c0528cb3b9ae2b9a3cfea054606f603a1e4 | | Linux x86_64 (AppImage) | 0.2.50 | AERIS-OS-0.2.50-x86_64.AppImage | 165,571,064 bytes | da2aaa7cf7344cb3a82e92451f21aa195a59d2679d028654406a34cf4ed12d82 | | Windows 10/11 x64 | 0.2.7 | AERIS-OS-0.2.7-Setup.exe | 54,375,804 bytes | 3a8a615c579bc17540fa52571597676fb2fba282e5da928d820c1871bc8a7100 | | macOS | not available yet | | | | Machine-readable: https://www.emergencerising.com/aerisOS/latest.json · Checksums: https://www.emergencerising.com/aerisOS/linux/SHA256SUMS, https://www.emergencerising.com/aerisOS/windows/SHA256SUMS ## 0. Before you start - Tell the person what you are about to install and that they will need to sign in at the end. - AERIS OS needs a paid E:MERGENCE account to get past first launch. $19.99/month includes AERIS OS; the Free plan covers the mobile apps only. Plans: https://www.emergencerising.com/pricing - Never pipe an unverified download into a shell. The scripts below verify sha256 before installing anything. ## 1. Detect the platform - Linux: `uname -s` is `Linux` and `uname -m` is `x86_64`. Check glibc with `getconf GNU_LIBC_VERSION` (need 2.35 or newer). Go to step 2. - Windows: 64-bit Windows 10 or 11. Go to step 3. - macOS or anything else (ARM Linux, musl/Alpine, 32-bit): stop and tell the person AERIS OS is not available for that system yet. ## 2. Linux Requirements: x86_64 (amd64) CPU; glibc 2.35 or newer (Ubuntu 22.04+, Debian 12+ and derivatives); A graphical desktop session; A desktop keyring for sign-in (GNOME Keyring or KWallet). ### 2a. One command (recommended) ```sh curl -fsSL https://www.emergencerising.com/aerisOS/install.sh | sh ``` The script checks x86_64 and glibc, downloads the versioned package, verifies it against https://www.emergencerising.com/aerisOS/linux/SHA256SUMS and only then installs: - Debian/Ubuntu (apt present): installs the .deb with `apt-get install` so dependencies resolve. Needs root: it uses `sudo` when available, or run it as root. - Other distributions: installs the AppImage for the current user at `~/.local/bin/aeris-os` plus a menu entry. Options (pass after `sh -s --`): `--dry-run` (show what would happen, install nothing), `--download-only`, `--deb`, `--appimage`, `--dir DIR`. Example: `curl -fsSL https://www.emergencerising.com/aerisOS/install.sh | sh -s -- --dry-run` To read the script before running it: `curl -fsSLO https://www.emergencerising.com/aerisOS/install.sh && less install.sh && sh install.sh` ### 2b. Manual .deb (Debian 12+, Ubuntu 22.04+) ```sh curl -fLO https://www.emergencerising.com/aeris-os-downloads/linux/AERIS-OS-0.2.50-amd64.deb echo "5dcb91ca66b89ba93da620b901505c0528cb3b9ae2b9a3cfea054606f603a1e4 AERIS-OS-0.2.50-amd64.deb" | sha256sum -c - sudo apt-get install -y ./AERIS-OS-0.2.50-amd64.deb ``` Use `apt-get install ./file.deb`, not `dpkg -i`, so the dependencies (libgomp1, python3, libayatana-appindicator3-1, libwebkit2gtk-4.1-0, libgtk-3-0) are installed. Check: `dpkg-query -W -f='${Version}\n' aeris-os` prints `0.2.50`. The app binary is `/usr/bin/aeris-os`. ### 2c. Manual AppImage (other distributions) ```sh curl -fLO https://www.emergencerising.com/aeris-os-downloads/linux/AERIS-OS-0.2.50-x86_64.AppImage echo "da2aaa7cf7344cb3a82e92451f21aa195a59d2679d028654406a34cf4ed12d82 AERIS-OS-0.2.50-x86_64.AppImage" | sha256sum -c - chmod +x AERIS-OS-0.2.50-x86_64.AppImage ./AERIS-OS-0.2.50-x86_64.AppImage ``` AppImages need FUSE 2 (`libfuse2`, or `libfuse2t64` on Ubuntu 24.04). Without it, run with `--appimage-extract-and-run`. ## 3. Windows Requirements: Windows 10 or Windows 11, 64-bit (x64). ### 3a. One command (PowerShell) ```powershell irm https://www.emergencerising.com/aerisOS/install.ps1 | iex ``` The script downloads the versioned installer, checks it with `Get-FileHash` against https://www.emergencerising.com/aerisOS/windows/SHA256SUMS, and runs it silently (`/S`). Dry run: `$env:AERIS_DRY_RUN = '1'; irm https://www.emergencerising.com/aerisOS/install.ps1 | iex` ### 3b. Manual ```powershell Invoke-WebRequest -UseBasicParsing -Uri https://www.emergencerising.com/aeris-os-downloads/windows/AERIS-OS-0.2.7-Setup.exe -OutFile AERIS-OS-0.2.7-Setup.exe (Get-FileHash .\AERIS-OS-0.2.7-Setup.exe -Algorithm SHA256).Hash # must equal 3A8A615C579BC17540FA52571597676FB2FBA282E5DA928D820C1871BC8A7100 Start-Process .\AERIS-OS-0.2.7-Setup.exe -ArgumentList '/S' -Wait ``` Leave out `-ArgumentList '/S'` to run the normal installer window. ## 4. Hand off to the person (required) Installation is done when the package is installed. Setup is not: the first launch needs the person. Say this to the person: > AERIS OS is installed. Open it (menu entry "AERIS OS"; on Linux you can also run `aeris-os`) and sign in with your E:MERGENCE account. Sign-in needs a paid account: $19.99/month includes AERIS OS, and the Free plan covers the mobile apps. On Linux, sign-in stores its session in your desktop keyring (GNOME Keyring or KWallet). Do not try to sign in for them, and do not ask for their password. ## 5. Uninstall - Debian/Ubuntu: `sudo apt-get remove aeris-os` - AppImage: delete `~/.local/bin/aeris-os` and `~/.local/share/applications/aeris-os.desktop` - Windows: Settings > Apps > Installed apps > AERIS OS > Uninstall ## 6. If something fails - Checksum mismatch: do not install. Download again; if it still fails, a release may be in progress. Wait a few minutes and start over. - `404` on a versioned file: a newer release replaced it. Re-read https://www.emergencerising.com/aerisOS/latest.json or re-run the one-command installer. - glibc too old: the system is older than Ubuntu 22.04 / Debian 12. AERIS OS will not run there. - Linux sign-in fails to save: install and unlock a desktop keyring (GNOME Keyring or KWallet), then sign in again. Linux source commit: 35351023e9131ce606a21dae9927f170ab220864. Publisher: E:MERGENCE LLC, https://www.emergencerising.com/