https://github.com/stackitcloud/devpod-provider-stackit
The devpod-provider-stackit enables seamless integration of DevPod with STACKIT, facilitating the deployment of development environments on the STACKIT cloud platform
https://github.com/stackitcloud/devpod-provider-stackit
cloud-provider devcontainer devpod devpod-provider stackit stackit-cloud
Last synced: 10 days ago
JSON representation
The devpod-provider-stackit enables seamless integration of DevPod with STACKIT, facilitating the deployment of development environments on the STACKIT cloud platform
- Host: GitHub
- URL: https://github.com/stackitcloud/devpod-provider-stackit
- Owner: stackitcloud
- License: apache-2.0
- Created: 2025-03-12T14:27:02.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-12-10T15:18:24.000Z (about 2 months ago)
- Last Synced: 2025-12-24T07:55:54.304Z (about 1 month ago)
- Topics: cloud-provider, devcontainer, devpod, devpod-provider, stackit, stackit-cloud
- Language: Go
- Homepage: https://www.stackit.de
- Size: 494 KB
- Stars: 8
- Watchers: 3
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DevPod Provider for STACKIT
[](https://devpod.sh/open#provider=stackitcloud/devpod-provider-stackit)
[](https://goreportcard.com/report/github.com/stackitcloud/devpod-provider-stackit)
The DevPod Provider for STACKIT enables seamless integration between [DevPod](https://devpod.sh) and the [STACKIT Cloud Platform](https://www.stackit.de/en/), allowing you to deploy development environments on STACKIT's European cloud infrastructure. This provider offers a secure, GDPR-compliant solution for creating reproducible development environments in STACKIT's German data centers.
## Features
- Deploy development environments on STACKIT's cloud platform
- Automated VM provisioning and management
- GDPR-compliant European cloud infrastructure
- Full DevContainer compatibility
## Requirements
- [DevPod CLI](https://devpod.sh/docs/getting-started/installation) or [DevPod Desktop](https://devpod.sh/docs/getting-started/installation)
- STACKIT account with an active project
- Service Account with appropriate permissions
- Service Account Key and Private Key (for authentication)
## Installation
You can add the STACKIT provider to DevPod using the CLI:
```bash
devpod provider add stackitcloud/devpod-provider-stackit
```
Or through the DevPod Desktop application by clicking on "Providers" and then "Add Provider".
## Configuration
When adding the provider, you need to configure the following options:
| Option | Required | Description | Default |
|--------|----------|-------------|----------|
| REGION | true | The STACKIT region to create the VM in (e.g., `eu01`) | `eu01` |
| AVAILABILITY_ZONE | true | The availability zone to use (e.g., `eu01-1`, `eu01-2`) | `eu01-1` |
| PROJECT_ID | true | The STACKIT project ID to use | |
| DISK_SIZE | false | The disk size to use in GB | `64` |
| SERVICE_ACCOUNT_KEY_PATH | true | Path to your STACKIT Service Account Key JSON file | |
| PRIVATE_KEY_PATH | true | Path to your private key | |
| FLAVOR | false | The VM instance type to use | `g1.1` |
## Authentication
To authenticate with STACKIT, you need to:
1. Create a Service Account in the STACKIT Portal
2. Generate a key pair locally
3. Upload the public key to STACKIT
4. Download the Service Account Key JSON file
### Creating a Service Account Key
1. Log in to the [STACKIT Portal](https://portal.stackit.cloud/)
2. Navigate to your project
3. Go to "Service Accounts" tab
4. Create a new Service Account or select an existing one
5. Go to "Service Account Keys" and create a new key
6. Follow the instructions to upload your public key and download the Service Account Key JSON
For detailed instructions, see the [STACKIT documentation on creating service account keys](https://docs.stackit.cloud/stackit/en/create-a-service-account-key-175112456.html).
## Usage
After setting up the provider, you can create a new DevPod workspace:
```bash
# Create a new workspace from a Git repository
devpod up git@github.com:user/repository.git --provider stackit
# Or from a local directory
devpod up ./my-project --provider stackit
```
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the [Apache License 2.0](LICENSE).