- Introduction
- Getting Started
- Gitpod Tutorial
- Use Cases
- Languages
- Configure
- Workspaces
- User settings
- Repositories
- Organizations
- Authentication
- Billing
- References
- .gitpod.yml
- IDEs & editors
- Integrations
- Gitpod CLI
- Gitpod API
- Gitpod URL
- Compatibility
- Enterprise
- Overview
- Setup and Preparation
- Deploying
- Configure your Gitpod Instance
- Administration
- Upgrading
- Background
- Reference
- Archive
- Help
- Contribute
- Troubleshooting
Gitpod Enterprise Installation Process
Request your Enterprise trial
Deploying Gitpod Enterprise on AWS is a streamlined and secure process, designed to get your development environment up and running with minimal hassle. Here’s what to expect during the installation:
Communication with Account Managers: Your journey begins by communicating your AWS account ID and chosen region to your Gitpod account manager. This initial step ensures that our team is aligned with your setup preferences and requirements.
Applying CloudFormation (CF) Stacks: You will receive deep links to CloudFormation templates tailored for Gitpod deployment. The process starts with applying a CF stack that creates an IAM role with the necessary permissions, followed by the main Gitpod CF stack. These templates simplify the setup, allowing for a secure and compliant infrastructure deployment.
Setting Up SSO with Admin URL: After the infrastructure is in place, the next step involves setting up Single Sign-On (SSO). We’ll provide you with an admin URL to configure SSO, ensuring secure access control to your Gitpod Enterprise environment.
Sit Back and Relax: Once the setup is complete, you can relax while we manage your Gitpod installation. Our team monitors your system around the clock, providing uninterrupted service on your Gitpod instance, ensuring everything is optimized for performance and security.
Regular Upgrades: Gitpod Enterprise is continually improving, and you’ll receive updates for your CloudFormation templates. These updates can be applied with a one-click solution, keeping your environment up to date with the latest features and security enhancements.
This comprehensive approach ensures a hassle-free setup, allowing you to focus on what you do best — building great software. AWS Support and Regions
AWS Support and Regions
Gitpod Enterprise is currently supported exclusively on AWS, leveraging its robust and scalable infrastructure to provide a seamless development environment. Here are the key points regarding our AWS support:
Exclusive AWS Support:
Our deep integration with AWS services and infrastructure ensures that Gitpod Enterprise leverages the best of cloud technology, offering scalability, security, and reliability.
Supported AWS Regions:
To ensure optimal performance and compliance with data residency requirements, Gitpod Enterprise is available in specific AWS regions. Currently, we support the following regions:
us-east-1us-east-2us-west-2ap-northeast-1ap-southeast-2eu-west-1eu-west-2eu-west-3eu-central-1sa-east-1
This list is continually updated to reflect our expanding support and capabilities across AWS’s global infrastructure.
Choosing the right AWS region for your Gitpod Enterprise setup is crucial for minimizing latency and aligning with your organization’s data residency policies. Our team is here to assist in selecting the best region based on your specific needs.
Frequently Asked Questions
Q. Why two templates?
A. The gitpod-role CloudFormation template is used to create a role with the minimum permissions required to install and update Enterprise. This role and its policies are used to install the second Cloudformation template.
Q. Can the stack created by gitpod-role be deleted after executing the <company>-gitpod-template.json?
A. No, the stack created by gitpod-role should be maintained. The role created is also used when updates are provided to the <company>-gitpod-template.json template. For more details on infrastructure updates, please see Deployment and Updates.
Q. What happens if my Cloudformation stack fails to install? A. If the stack fails to install, you should delete the stack and try again. There are a few resources that need to be cleaned up manually before you attempt another installation. See Deleting your Gitpod installation for details.
Q. Can we grant public access to webhooks and IDP services without exposing the entire Gitpod application to the Internet?
A. Yes. Enterprise can be configured to expose webhooks and IDP services on public endpoints. This can be helpful for connecting to OIDC providers such as Okta, Azure AD. This option also makes it easy for developers to connect to your instance without having to route through a VPN or transit gateway. See Networking and Data flows for more information.
❓ Got Questions? Contact Support