# DevPod — Open-Source Dev Environments on Any Infrastructure

> DevPod by Loft Labs creates reproducible, containerized development environments that run on any cloud, Kubernetes cluster, or local Docker — all from a single devcontainer.json spec.

## Install

Save as a script file and run:

# DevPod — Open-Source Dev Environments on Any Infrastructure

## Quick Use
```bash
# Install DevPod CLI
curl -L -o devpod "https://github.com/loft-sh/devpod/releases/latest/download/devpod-linux-amd64"
chmod +x devpod && sudo mv devpod /usr/local/bin/

# Create a workspace from a Git repo using Docker provider
devpod up github.com/my-org/my-repo

# Connect via SSH
devpod ssh my-repo
```

## Introduction
DevPod is an open-source tool that lets developers spin up reproducible development environments based on the devcontainer.json standard. Unlike proprietary cloud IDEs, DevPod is client-only and infrastructure-agnostic — you pick the provider (Docker, Kubernetes, AWS, GCP, Azure, SSH) and DevPod handles provisioning, connecting your IDE, and tearing down when done. It gives you Codespaces-like convenience without vendor lock-in.

## What DevPod Does
- Creates containerized dev environments from any Git repository with a devcontainer.json
- Supports multiple infrastructure providers including Docker, Kubernetes, and major clouds
- Connects seamlessly to VS Code, JetBrains IDEs, or any SSH-capable editor
- Manages workspace lifecycle: create, stop, start, rebuild, and delete
- Provides a desktop GUI and CLI for managing environments and providers

## Architecture Overview
DevPod is a client-side application with no server component. When you run devpod up, it reads the devcontainer.json from the target repo, selects the configured provider, provisions a machine or container, clones the repo inside, installs the devcontainer tooling, and establishes an SSH tunnel back to your local IDE. Providers are plugins that abstract infrastructure differences. Because everything is client-driven, there is no central control plane to maintain.

## Self-Hosting & Configuration
- Install the DevPod CLI or desktop app on macOS, Linux, or Windows
- Add a provider with devpod provider add docker or devpod provider add kubernetes
- Configure provider options like machine type, region, or namespace via devpod provider set-options
- Place a devcontainer.json in your repository to define the base image, features, and extensions
- Use devpod up --ide vscode or --ide goland to auto-connect your preferred editor

## Key Features
- Infrastructure-agnostic design lets you move environments between local Docker and cloud with one flag
- Full devcontainer.json spec support including features, lifecycle hooks, and port forwarding
- Pre-built provider plugins for Docker, Kubernetes, AWS, GCP, Azure, and generic SSH hosts
- Desktop GUI with one-click workspace creation for teams less comfortable with CLI
- No server or SaaS dependency — runs entirely on the developer machine

## Comparison with Similar Tools
- **GitHub Codespaces** — excellent UX but locked to GitHub and VS Code, charges per compute hour
- **Gitpod** — powerful cloud IDE but requires a hosted control plane and workspace cluster
- **Coder** — self-hosted remote workspaces with Terraform templates, more complex to operate
- **Dev Containers CLI** — reference implementation but limited to local Docker, no cloud providers
- **Daytona** — similar open-source approach but newer with a smaller plugin ecosystem

## FAQ
**Q: Do I need a devcontainer.json to use DevPod?**
A: No. DevPod can create a default environment for any repo. A devcontainer.json just gives you finer control over the image, tools, and extensions.

**Q: Can my whole team share the same DevPod configuration?**
A: Yes. Commit the devcontainer.json to your repo and every developer gets an identical environment regardless of their local OS or chosen provider.

**Q: How does DevPod handle dotfiles and personal config?**
A: You can configure a dotfiles repository in DevPod settings. It clones and installs your dotfiles into every new workspace automatically.

**Q: Is DevPod free?**
A: DevPod itself is fully open-source and free. You only pay for the infrastructure you provision (cloud VMs, Kubernetes nodes, etc.).

## Sources
- https://github.com/loft-sh/devpod
- https://devpod.sh/docs

---
Source: https://tokrepo.com/en/workflows/df4899c5-3986-11f1-9bc6-00163e2b0d79
Author: Script Depot