2026-09-08 12:34:00 -04:00
---
title : Google Cloud Platform
---
2023-09-06 21:58:14 +03:00
In this guide, you will learn how to deploy the Coder control plane instance and
your first template.
## Requirements
This guide assumes you have `roles/compute.instanceAdmin.v1` access to your
Google Cloud Platform project.
## Launch a Coder instance from the Google Cloud Marketplace
2025-08-08 16:00:09 +10:00
We publish an Ubuntu 22.04 VM image with Coder and Docker pre-installed.
Two SKU's are available via the Google Cloud Marketplace:
1. [License purchase via Google Cloud Marketplace ](https://console.cloud.google.com/marketplace/product/coder-enterprise-market-public/coder-gcmp?inv=1&invt=Ab45rg&project=secret-beacon-468405-p5 )
2. [A solution to deploy VM's on GCP (Bring Your Own License) ](https://console.cloud.google.com/marketplace/product/workspan-public-422119/coder?inv=1&invt=Ab45rg&project=secret-beacon-468405-p5 )
2023-09-06 21:58:14 +03:00
2024-10-05 08:52:04 -07:00

2023-09-06 21:58:14 +03:00
Be sure to keep the default firewall options checked so you can connect over
HTTP, HTTPS, and SSH.
We recommend keeping the default instance type (`e2-standard-4` , 4 cores and 16
GB memory) if you plan on provisioning Docker containers as workspaces on this
VM instance. Keep in mind this platforms is intended for proof-of-concept
deployments and you should adjust your infrastructure when preparing for
2024-10-05 08:52:04 -07:00
production use. See: [Scaling Coder ](../../admin/infrastructure/index.md )
2023-09-06 21:58:14 +03:00
<video autoplay playsinline loop>
2026-06-22 11:39:12 -04:00
<source src="../../images/platforms/gcp/launch.mp4?raw=true" type="video/mp4">
2023-09-06 21:58:14 +03:00
Your browser does not support the video tag.
</video>
Be sure to add a keypair so that you can connect over SSH to further
2024-10-05 08:52:04 -07:00
[configure Coder ](../../admin/setup/index.md ).
2023-09-06 21:58:14 +03:00
After launching the instance, wait 30 seconds and navigate to the public IPv4
address. You should be redirected to a public tunnel URL.
2024-10-05 08:52:04 -07:00

2023-09-06 21:58:14 +03:00
That's all! Use the UI to create your first user, template, and workspace. We
recommend starting with a Docker template since the instance has Docker
pre-installed.
2024-10-05 08:52:04 -07:00

2023-09-06 21:58:14 +03:00
## Configuring Coder server
Coder is primarily configured by server-side flags and environment variables.
Given you created or added key-pairs when launching the instance, you can
2024-10-05 08:52:04 -07:00
[configure your Coder deployment ](../../admin/setup/index.md ) by logging in via
SSH or using the console:
2023-09-06 21:58:14 +03:00
2026-07-15 14:07:09 -04:00
```sh
2023-09-06 21:58:14 +03:00
ssh ubuntu@<gcp-public-IPv4>
sudo vim /etc/coder.d/coder.env # edit config
sudo systemctl daemon-reload
sudo systemctl restart coder # restart Coder
```
## Give developers VM workspaces (optional)
Instead of running containers on the Coder instance, you can offer developers
full VM instances with the
2026-06-29 13:12:19 -04:00
[gcp-linux ](../../../examples/templates/gcp-linux/README.md )
2023-09-06 21:58:14 +03:00
template.
Before you can use this template, you must authorize Coder to create VM
instances in your GCP project. Follow the instructions in the
2026-06-29 13:12:19 -04:00
[gcp-linux template README ](../../../examples/templates/gcp-linux/README.md#authentication )
2023-09-06 21:58:14 +03:00
to set up authentication.
2024-10-05 08:52:04 -07:00
### Next Steps
2023-09-06 21:58:14 +03:00
2024-10-05 08:52:04 -07:00
- [Use your IDE with Coder ](../../user-guides/workspace-access/index.md )
- [Writing custom templates for Coder ](../../admin/templates/index.md )
- [Configure the Coder server ](../../admin/setup/index.md )
- [Use your own domain + TLS ](../../admin/setup/index.md#tls--reverse-proxy )