Quickstart¶
Install HybridOps.Core and prepare an environment for a documented workflow.
1. Install¶
Cross-platform packages are available from the latest stable release. Choose the package for your workstation. Preview and previous releases are also available.
Download for Linux, extract it, open the folder in a terminal, and run:
./install.sh
Download the macOS package for
Apple silicon
or Intel.
Open the .pkg and follow the installer.
The package is not notarized. If macOS blocks the first launch, open System Settings → Privacy & Security and approve the package.
Download for Windows 11,
extract all files, and open Install HybridOps.cmd.
The installer prepares Ubuntu 24.04 on WSL2 and installs Core in that environment. Approve the Windows administrator prompt if WSL is not already installed. If Windows requests a restart, restart and run the installer again. After installation, use the desktop shortcut to open the HybridOps terminal.
2. Verify¶
Open a new terminal and verify the installation:
hyops --help
3. Prepare a target¶
Run one setup command for the intended target:
hyops setup gcp
hyops setup azure
hyops setup proxmox
Setup requests administrator approval when system changes are required.
4. Initialise a target environment¶
Replace <env> with a name for the environment and use it consistently:
hyops init gcp --env <env>
hyops init azure --env <env>
hyops init proxmox --env <env>
hyops init hetzner --env <env>
Confirm that the environment is ready:
hyops preflight --env <env>
5. Choose a workflow¶
Select a module or blueprint, then follow its linked runbook.
For environment requirements, see network prerequisites and secrets lifecycle.