Install Aseptic

Aseptic is distributed as a desktop application packaged for Windows, macOS and Linux. It is not cloned or built from source: you install it from the corresponding installer.

Before installing

• Docker Desktop (or a compatible Docker daemon). Aseptic launches the common infrastructure (Kafka, Redis, PostgreSQL) and container-mode micros with Docker. You can install Aseptic without Docker, but you won’t be able to start scenarios with infrastructure or containers until you have it.
• Your micros’ repositories cloned on your machine (or clone them later from the app itself with “Import micro from Git”).

You don’t need to install Java, Node or Python in any special way: to start each micro, Aseptic uses the repo’s own wrapper (mvnw), the .venv or the binary on your PATH, just as you would by hand.

Download

From aseptic.dev (downloads section), choose your operating system:

System	Installer
Windows	Aseptic-Setup.exe
Linux	Aseptic.AppImage (or the .deb package)
macOS	See the downloads section (during the beta it may not be packaged)

The file downloads directly. The latest version always points to the most recent one.

Install

• Windows: run Aseptic-Setup.exe and follow the wizard.
• Linux: make the AppImage executable (chmod +x Aseptic.AppImage) and open it, or install the .deb with your package manager.
• macOS: open the .dmg and drag Aseptic to Applications.

Automatic updates

Aseptic checks for updates on startup and notifies you when there is a new version (you’ll see a notice next to Settings). You can also check manually in Settings → About → Check for updates. When one is available, it downloads and installs on restart; you don’t have to go back to the website.

Next step

• First launch: sign-in, consent and diagnostics.
• Your first scenario in 5 minutes.