Deploy a Go (Gin) app

New to seenode? Start free: 7-day trial, no credit card. Apps run on credit-based pricing from $3/mo.

This guide explains how to deploy your existing Gin application to seenode.

Prerequisites

Before you begin, ensure you have:

• A seenode account (sign up free)
• Git configured on your machine
• Existing Gin project ready to deploy

Configure for seenode Deployment

Port Configuration

Your service must listen on the same port that you configure in the Port field for the web service. Choose a port (for example, 80 or 8080) and use it both in your code and in the dashboard.

For more background on how the Port field controls routing on seenode, see Configuring Your Application’s Port.

1
package main
2

3
import (
4
    "fmt"
5

6
    "github.com/gin-gonic/gin"
7
)
8

9
func main() {
10
    r := gin.Default()
11

12
    r.GET("/", func(c *gin.Context) {
13
        c.String(200, "Hello, Welcome to seenode 👋")
14
    })
15

16
    r.Run(":80")
17
}

::::note[Why this matters] On seenode, the Port field defaults to 80, and traffic is routed to whatever value it holds, so your app must listen on that same port on host 0.0.0.0 (for example, 80). You don’t need to set a PORT environment variable; just bind your app to the port shown in the Port field. ::::

Dependencies

Make sure your go.mod lists gin-gonic/gin as a dependency:

1
module your-gin-project
2

3
go 1.21
4

5
require github.com/gin-gonic/gin v1.9.1

Run go mod tidy to create your go.sum file.

Deploy on seenode

::::tip[Troubleshooting] If your deployment fails, the first place to check is the Logs tab in your seenode service dashboard. Build and runtime logs often contain valuable information for diagnosing issues.

Port configuration mismatch

• On seenode, the Port field defaults to 80. Ensure your application listens on host 0.0.0.0 and the port set there.
• Adjust your framework code if needed (for example, change the port value in r.Run(":80") to match the Port field).
• Seeing a 502 Bad Gateway? Your app may not be listening on the expected port. ::::

Starting from Scratch?

If you don’t have a Gin project yet:

Option 1: Use our Template (Recommended)

Option 2: Create from Gin Docs + seenode Setup

Follow the official Gin documentation to create a new project, then return here for seenode-specific deployment steps.

seenode-Specific Setup Steps:

1. Create Go module: go mod init your-project
2. Install Gin: go get github.com/gin-gonic/gin
3. Configure your server to listen on the port you’ll set in the dashboard (for example, 80 or 8080)

Next Steps

Now that your Gin application is deployed, here are some things you might want to do next: