Skip to content
Overlordiusalpha
EN — Read this page in PortugueseSign in

Installation

Get Overlordius ready on your Windows or Linux computer, then continue to your first use in the app.

Before you install

  • Windows on x64.
  • Or Linux on x64: a distribution with glibc 2.38 or newer, such as Ubuntu 24.04 LTS, with GTK 3, NSS, FUSE (fusermount3 or fusermount), unshare and user namespaces, and a Secret Service (such as GNOME Keyring) or KWallet.
  • git available in your PATH.
  • An Overlordius account, created with a single-use invitation code in the app or on the website.
  • An API key from at least one AI provider: Anthropic, OpenAI, DeepSeek or OpenRouter.

macOS, ARM computers and Linux distributions with an older glibc, such as Ubuntu 22.04, are not supported.

Install on Windows

  1. Download the installer

    Sign in on the download page to get the Windows installer. The download is about 330.6 MB.

    Go to download

  2. Run the installer

    Overlordius installs for the current user without administrator privileges, in %LOCALAPPDATA%\Programs\Overlordius. The installed app takes up about 1.1 GB.

    The installer asks you to accept the license. You can read the Terms of use before installing.

    Claude Code and Codex are bundled with the app. You do not need npm.

Windows SmartScreen warning

The installer is deliberately unsigned, so SmartScreen shows a warning during installation and with each new version.

Click “More info”, then “Run anyway”.

Updates are protected by Overlordius’s own signing key. The app rejects any update that has not been signed by Overlordius.

Install on Linux

  1. Download the AppImage

    Sign in on the download page to get the Linux AppImage. The download is about 391.7 MB.

    Go to download

  2. Make it executable and run it

    The AppImage is the whole app in one file, with nothing to install. Keep it in a folder you can write to, such as ~/Applications: updates replace the file there. From a terminal:

    mkdir -p ~/Applications
mv ~/Downloads/Overlordius-*-x86_64.AppImage ~/Applications/
chmod +x ~/Applications/Overlordius-*-x86_64.AppImage
~/Applications/Overlordius-*-x86_64.AppImage

    Claude Code and Codex are bundled with the app. You do not need npm.

  3. Ubuntu 23.10 and later: allow the sandbox

    These versions restrict user namespaces with AppArmor, so the app would start without its sandbox. Check with cat /proc/sys/kernel/apparmor_restrict_unprivileged_userns: 1 means restricted. If so, add this profile once, then restart the app:

    sudo tee /etc/apparmor.d/overlordius >/dev/null <<'EOF'
abi <abi/4.0>,
include <tunables/global>

profile overlordius "FOLDER/Overlordius*.AppImage" flags=(unconfined) {
  userns,

  include if exists <local/overlordius>
}
EOF
sudo apparmor_parser -r /etc/apparmor.d/overlordius

    Replace FOLDER with the full path of the AppImage's folder, such as /home/ana/Applications. Moving the AppImage to another folder needs the profile again. To remove it: sudo apparmor_parser -R /etc/apparmor.d/overlordius, then delete the file.

  4. Keep a keyring running

    Overlordius encrypts your session and keys with your desktop's keyring: a Secret Service, such as GNOME Keyring, or KWallet. Keep it installed and unlocked when you open the app.

Automatic updates

Overlordius checks for updates when it opens and every six hours. It downloads them without interrupting your work, then offers “Restart to update”.

On Linux, automatic updates work when you start the app from its AppImage file.

Your local data

Your data is stored in %APPDATA%\Overlordius on Windows and ~/.config/Overlordius on Linux. Your session and keys are encrypted.

Ready for your first use?

Continue to How to use