Deploy Gin App on Seenode | Gin Hosting & Deployment Guide

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

Prerequisites

Before you begin, ensure you have:

• A seenode account at seenode.com
• 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, there is no default container port and traffic is routed to whatever value you set in the Port field, so your app must listen on that same port (for example, 80). Do not rely on a PORT environment variable, as seenode does not provide one. ::::

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, there is no default container port. Ensure your application listens on the port you configured in the Port field.
• 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: