Hosted edition
KeplerCrew Cloud
Nothing to install. Sign in and your crew is ready — projects, cycles and delivery run on managed infrastructure.
Enterprise edition
Self-hosted, on your machine
License key requiredThe complete KeplerCrew engine — installed on your own infrastructure, with model connectivity and data boundaries determined by your configuration. The installer requires a license key; model and integration credentials depend on your setup.
powershell -NoProfile -ExecutionPolicy Bypass -Command "iex (irm https://get.keplercrew.com/install.ps1)" curl -fsSL https://get.keplercrew.com/install.sh | sh The installer:
- Validates your license key before downloading anything.
- Downloads the latest bundle your license is entitled to, over HTTPS.
- Verifies the SHA256 checksum against the release metadata.
- Installs per-user — no administrator access required.
- Stores your license key locally with user-only permissions, then launches.
Run updates from the client machine by re-running the same command - no new key entry, no site visit.
- Your stored license key is reused automatically.
- If you are already on the latest release, the installer exits with "up to date".
- The running KeplerCrew stops, updates in place, and relaunches.
| Option | Effect |
|---|---|
KEPLER_LICENSE_KEY | Your license key (skips the interactive prompt) |
KEPLER_VERSION | Pin a version for one command (default: latest) |
KEPLER_DRY_RUN=1 | Resolve and print the release without installing |
KEPLER_INSTALL_DIR | Custom install directory |
KEPLER_NO_LAUNCH=1 | Install without launching |
KEPLER_FORCE | Set to 1 to reinstall the current version |
One command removes KeplerCrew and frees your license seat, so the same key can be activated on another machine.
powershell -NoProfile -ExecutionPolicy Bypass -Command "iex (irm https://get.keplercrew.com/uninstall.ps1)" curl -fsSL https://get.keplercrew.com/uninstall.sh | sh - Stops KeplerCrew and removes the install directory.
- Frees your license seat — the same key can then be activated elsewhere.
- Removes the
keplercommand from your PATH. -
Keeps your projects and history in
%USERPROFILE%\.kepler-trial(~/.kepler-trialon Linux) — a later reinstall picks them up again.
| Uninstall option | Effect |
|---|---|
KEPLER_PURGE=1 | Also delete your projects, cycles and logs |
KEPLER_KEEP_LICENSE=1 | Keep the seat activated (reinstalling on this same machine) |
KEPLER_YES=1 | Skip the confirmation prompt (unattended) |
KEPLER_INSTALL_DIR | Uninstall from a custom install directory |
machine count has exceeded maximum. If that has already
happened, write to
support@aichargelabs.com and we will release
the seat.
Set options as environment variables before the install
command, on their own line. PowerShell has no VAR=value command
form — typing KEPLER_FORCE=1 alone gives
"is not recognized as a name of a cmdlet".
NOT_FOUND? The installer reuses the key
stored from a previous install, and that key no longer exists.
KEPLER_FORCE will not fix it — it only
re-installs, still using the same dead key. Use scenario 1 or 2 below.
Use this whenever the installer reports NOT_FOUND, EXPIRED or SUSPENDED — a stored key is reused automatically, so you must override it.
powershell -NoProfile -ExecutionPolicy Bypass -Command "$env:KEPLER_LICENSE_KEY='key/YOUR-KEY-HERE'; iex (irm https://get.keplercrew.com/install.ps1)" curl -fsSL https://get.keplercrew.com/install.sh | KEPLER_LICENSE_KEY='key/YOUR-KEY-HERE' sh KEPLER_FORCE does NOT replace a bad key — it only re-installs. To stop reusing a dead key, delete it, then run the installer and paste the new one when asked.
Remove-Item -Force "$env:LOCALAPPDATA\Programs\KeplerCrew\licenses\customer.key"
powershell -NoProfile -ExecutionPolicy Bypass -Command "iex (irm https://get.keplercrew.com/install.ps1)" rm -f "$HOME/.local/share/keplercrew/licenses/customer.key"
curl -fsSL https://get.keplercrew.com/install.sh | sh For when the installer says "up to date" but you want the files rewritten.
powershell -NoProfile -ExecutionPolicy Bypass -Command "$env:KEPLER_FORCE=1; iex (irm https://get.keplercrew.com/install.ps1)" curl -fsSL https://get.keplercrew.com/install.sh | KEPLER_FORCE=1 sh Pin a release instead of taking the latest. This applies to THIS command only — your shell keeps installing the latest afterwards.
powershell -NoProfile -ExecutionPolicy Bypass -Command "$env:KEPLER_VERSION='8.0.0'; iex (irm https://get.keplercrew.com/install.ps1)" curl -fsSL https://get.keplercrew.com/install.sh | KEPLER_VERSION='8.0.0' sh Resolves your license and the release, prints both, installs nothing. Send us this output if you are stuck.
powershell -NoProfile -ExecutionPolicy Bypass -Command "$env:KEPLER_DRY_RUN=1; iex (irm https://get.keplercrew.com/install.ps1)" curl -fsSL https://get.keplercrew.com/install.sh | KEPLER_DRY_RUN=1 sh Useful for locked-down machines or side-by-side installs.
powershell -NoProfile -ExecutionPolicy Bypass -Command "$env:KEPLER_INSTALL_DIR='D:\Kepler'; $env:KEPLER_NO_LAUNCH=1; iex (irm https://get.keplercrew.com/install.ps1)" curl -fsSL https://get.keplercrew.com/install.sh | KEPLER_INSTALL_DIR="$HOME/kepler" KEPLER_NO_LAUNCH=1 sh | Message | Meaning | Do this |
|---|---|---|
NOT_FOUND | The stored key no longer exists (not an expiry). | Scenario 1, or 2 to clear it |
EXPIRED | The key’s term ended. | Email us to renew, then scenario 1 |
SUSPENDED | The key is on hold. | Email us to reinstate |
machine count has exceeded maximum | Already activated on another machine. | Uninstall on that machine to free the seat, or email us |
is not recognized as a name of a cmdlet | bash syntax used in PowerShell. | Put $env:NAME='value' on its own line first |
up to date | Already on that version. | Scenario 3 to re-install anyway |
Still stuck? Run scenario 5 and send us the output — it shows which license and release resolved, and installs nothing.