KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #deepseek-harness #typescript #ai-agent #codex #developer-tools #claude-code #windows #mcp #python #desktop-app

Kargo

★ 149 Open GitHub ↗

Kargo Private Cloud Platform

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

---
cwd: /workspaces/Kargo
runme:
  version: "3"
skipPrompts: false
---

# Kargo - The Cloud-Native ESXi Replacement

[![Quickstart Test](https://github.com/ContainerCraft/Kargo/actions/workflows/readme.yaml/badge.svg)](https://github.com/ContainerCraft/Kargo/actions/workflows/readme.yaml)

## Overview

Kargo replaces traditional hypervisors with a cloud-native container and virtualization platform. Kargo works seamlessly in on-prem, cloud, and local environments, leveraging Kubernetes to create a robust and scalable platform for modern compute and platform as a service use cases.

Join Kargo users and contributors in the [ContainerCraft Community Discord](https://discord.gg/Jb5jgDCksX)!

![Kargo in Konductor Github CodeSpaces Devcontainer](https://raw.githubusercontent.com/ContainerCraft/Kargo/main/.github/images/kargo-in-codespaces.png)

> **Note:** Kargo is in early development. Checkout [@usrbinkat](https://twitter.com/usrbinkat)'s [inaugural Twitter/X Thread](https://x.com/usrbinkat/status/1749186949590794551) to see how it all started.

## Project Goals

- Simplify Kubernetes skills development
- Accelerate project ideation and innovation
- Build a shared platform for community collaboration
- Develop an enterprise-grade hyperconverged compute platform
- Foster community equity through a reliable and inclusive platform
- Bring the power of cloud native to homelabs and students

## Getting Started

Try Kargo with just a browser to get started with [GitHub Codespaces](https://github.com/features/codespaces) following the steps below.

### Prerequisites

Ensure you have the following tools and accounts:

1. [GitHub](https://github.com)
2. [Pulumi Cloud](https://app.pulumi.com/signup)
3. [Microsoft Edge](https://www.microsoft.com/en-us/edge) or [Google Chrome](https://www.google.com/chrome)

### Quickstart

Check out the video to see Kargo deploy for yourself, or try it in your browser with the steps below.

#### Step-by-Step Instructions

1. **Log in to GitHub.**
2. **Launch Kargo in GitHub Codespaces:**

- Use the [Launch Kargo](https://bit.ly/launch-kargo-kubevirt-paas-in-github-codespaces) link directly or use the green `Code` button above to start a new Codespace.
   - Create a new Codespace with the following options:
      - **Branch:** `main`
      - **Dev Container Configuration:** `konductor`
      - **Region:** Your choice
      - **Machine Type:** 4 cores, 16 GB RAM, or better

3. **Open the VSCode Integrated Terminal:**

- Use key combination `[ Ctrl + ` ]` to open the terminal.

4. **Authenticate Credentials**

```bash {"excludeFromRunAll":"false","name":"login","terminalRows":"15"}
task login
```

5. **Configure:**

Configure the Pulumi IaC Stack parameters.

```bash {"excludeFromRunAll":"false","name":"configure","terminalRows":"10"}
# confirm Pulumi stack
export ORGANIZATION="${GITHUB_USER:-${GITHUB_REPOSITORY_OWNER:-}}"
export DEPLOYMENT="${RepositoryName:-}"
task configure
echo "Configured Pulumi stack: ci"
```

6. **Deploy Kubernetes:**

Deploy Kubernetes using Talos.

```bash {"excludeFromRunAll":"true","name":"deploy-kubernetes","terminalRows":"30"}
task kubernetes
```

7. **Deploy Platform:**

Deploy the Kubevirt PaaS IaC to Kubernetes.

```bash {"excludeFromRunAll":"true","name":"deploy","terminalRows":"128"}
task deploy
```

8. **Deploy a Virtual Machine:**

Deploy an Ubuntu Virtual Machine on the platform using Kubevirt.

> **Note:** Run this step manually via integrated terminal.

```bash {"excludeFromRunAll":"false","name":"deploy-virtual-machine","terminalRows":"40"}
# Purge old known host fingerprints
task ssh-clean

# Enable the VM instance
pulumi config set --path vm.enabled true

# Deploy the Kubevirt VM instance
pulumi up --skip-preview --refresh=false
```

9. **SSH to the new VM Instance:**

Access the VM via SSH using a Kubernetes NodePort service.

```bash {"excludeFromRunAll":"false","name":"ssh-cmd-vm-screenfetch","terminalRows":"38"}
ssh -p 30590 -i ~/.ssh/id_rsa -o UserKnownHostsFile=/dev/null kc2@localhost screenfetch
```

10. **Virtctl SSH:**

Use `virtctl` to access the VM via SSH without a NodePort service.

```bash {"excludeFromRunAll":"true","name":"virtctl-ssh","terminalRows":"48"}
# SSH using virtctl
virtctl ssh kc2@ubuntu
```

11. **Virtctl Serial Console:**

Use `virtctl` to access the serial console of the VM.

```bash {"excludeFromRunAll":"true","name":"virtctl-console","terminalRows":"48"}
# Serial console access
virtctl console ubuntu
```

> **Tip:** To exit the serial console, press `Ctrl + ]` or close the terminal.

12. **Cleanup:**

Clean up all Kubernetes and Pulumi resources.

```bash {"excludeFromRunAll":"true","name":"clean-all","terminalRows":"15"}
task clean-all
```

## Contributing

Kargo thrives on community contributions. Learn how to get involved by reading our [CONTRIBUTING.md](https://github.com/ContainerCraft/Kargo/issues/22).

### Developing Kargo

Use our GitHub Actions integration and the `act` tool to test CI pipelines locally before pushing your changes.

To test Kargo CI locally:

```bash {"excludeFromRunAll":"true"}
task act
```

## Join the Community + Learn More

For more discussion, support, and contribution, join our [ContainerCraft Community Discord Kargo Channel](https://discord.gg/Jb5jgDCksX).

For more information, explore the [Kargo Project FAQ](FAQ.md).

Kargo

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README