---
description: A guide to deploying a Go application from GitHub.
---

# Go

Deploy a Go application and learn how to host backend code on Code Capsules.

## Set up

Code Capsules connects to GitHub repositories to deploy applications. To follow this guide, you'll need a [Code Capsules](https://codecapsules.io/) account and a [GitHub](https://github.com/) account.

To demonstrate how to deploy a Go application with Code Capsules, we've provided an example application, which you can find on the [Code Capsules GitHub repository](https://github.com/codecapsules-io/go-demo).

Sign in to GitHub, and fork the example application by clicking "Fork" at the top-right of your screen and selecting your GitHub account as the destination.

## Create an Account with Code Capsules

If you don't already have an account, navigate to the [Code Capsules](https://codecapsules.io/) site and click the "Sign Up" button in the top right corner of the screen. Enter your details to create an account, or log in to an existing one.

If you've just signed up for an account, you'll be directed to a welcome page on your first login. Click on the "Go To Personal Team" button.

Alternatively, if you're signing in again, click on the "Spaces" tab.

Code Capsules gives every account a Personal Team by default. A Team is an environment for you to manage your Spaces and Capsules. For a better understanding of Teams, Spaces, and Capsules, take a look at [our explanation](https://github.com/codecapsules-io/codecapsules-docs/blob/main/platform/platform.md).

## Create a Space for your App

Log in to your Code Capsules account and navigate to the "Spaces" tab. Once there, click the yellow `+` icon on the bottom left of the screen to add a new Space.

Follow the prompts, choosing your region and giving your Space a name, then click "Create Space".

![Create a Space](https://1745662548-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxjp0G5hHSJs8nyv5Z5g7%2Fuploads%2Fn7P8LLvoCkOw1z5a0ipl%2Fspace-name.png?alt=media\&token=b0cbb338-e541-4e26-8ff9-259b9ee93357)

Example instructions to go with numbered annotations

1. Choose a Team — you can use a default "personal" Team if you're the only person working on this project, or a named Team if you're collaborating with others
2. This should remind you of the project, for example, "customer-api" or "notetaking-app"
3. Choose a country close to where most of your users will be

## Create the Capsule

A [Capsule](https://app.gitbook.com/s/gIlxo9gU7Lotj1cdGRh6/capsules/what-is-a-capsule) provides the server for hosting an application on Code Capsules.

Navigate to the "Space" containing your recently created Data Capsule and click the yellow `+` icon on the bottom left of the screen. Follow the instructions below to create a Backend Capsule:

1. Choose "Backend Capsule", your Team, and Space.
2. Choose your payment plan.
3. Click the GitHub button and give access to the repository you forked at the start of the tutorial.
4. Choose the GitHub repository you forked.
5. Press "Next".
6. Leave "Run Command" blank.
7. Click "Create Capsule".

Code Capsules will automatically build your application when you've finished creating the Capsule. While the build is in progress, you can view the log by clicking "View Build Progress" next to the "Building Capsule" message.

Once your application is live, you can view the build log by selecting the "Deploy" tab and clicking the "View build log" link in the "Builds" section.

![Build Logs](https://1745662548-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxjp0G5hHSJs8nyv5Z5g7%2Fuploads%2FBaSvJWIjVxmPYMOF4imG%2Fbackend-capsule-build-logs.png?alt=media\&token=ef31e4c3-107b-4bbc-83a1-44c635cd3e94)

## Binding the Capsules

Now you need to bind the two capsules together. Navigate to the "Config" tab of the Backend Capsule you've just created. Scroll to the "Bind Data Capsule" section and click on the "Bind". This enables the capsule to use the Persistent database in the Data Capsule.

![Bind Capsules](https://1745662548-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxjp0G5hHSJs8nyv5Z5g7%2Fuploads%2F5V0ZITezH9wR2mecyhlK%2FCleanShot%202025-05-29%20at%2016.34.51%402x.png?alt=media\&token=5b291c41-d433-475e-90e1-3238713578ea)

## View Application

Restart your capsule by toggling the radio button in the top right off and on again.

Once the build is complete, click the "URL" link in the "Details" tab, and you should see your deployed application.

![Deployed App](https://1745662548-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxjp0G5hHSJs8nyv5Z5g7%2Fuploads%2FKUff3ry8fgrDaAx9R8L9%2Fcc-go-app.png?alt=media\&token=b82d427e-9f47-4f9b-bbda-6d2f4d8cd328)

If you’d like to deploy another application in a different language or framework, take a look at our other [deployment guides](../get-started).
