Quickstart: Deploy a Gin App

This guide explains how to deploy a Gin application to seenode.

Deploy a Gin Template

Get started in seconds by deploying our pre-configured Gin template. This example is ready to deploy and reflects the structure discussed in this guide.

Gin Template

Deploy a minimal, production-ready Gin application with optimized performance.

Deploying an Existing Gin Project

Follow these steps to prepare and deploy your Gin project.

Prerequisites

• A seenode account.
• An existing Gin project pushed to a GitHub or GitLab repository.

Don’t have a project yet?

You can fork our Gin quickstart project.

Once you’ve forked the repository, you can start your 7-day free trial by deploying it on seenode.

1. Prepare Your Project for Production

   Your project structure should be ready for deployment.

   Project Structure

   A minimal Gin project contains a main.go entry point and a go.mod file.

   • Directoryyour-gin-project/

     • main.go // The application entry point
     • go.mod
     • go.sum

   Dependencies

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

   go.mod

   module your-gin-project
   
   go 1.21
   
   require github.com/gin-gonic/gin v1.9.1

   Run

   go mod tidy

   to create your go.sum file.

   Alternative Setup

   If you want to start from scratch, you can set up a new Gin project with these commands:

   Linux

   # Install Go (if you haven't yet)
   sudo apt update && sudo apt install golang-go
   
   # Create a new project
   mkdir your-gin-project
   cd your-gin-project
   go mod init your-gin-project
   go get github.com/gin-gonic/gin

   macOS

   # Install Go using Homebrew (if you haven't yet)
   brew install go
   
   # Create a new project
   mkdir your-gin-project
   cd your-gin-project
   go mod init your-gin-project
   go get github.com/gin-gonic/gin

   Windows

   # Install Go from https://golang.org/dl/
   # Download and run the installer, then restart your terminal
   
   # Create a new project
   mkdir your-gin-project
   cd your-gin-project
   go mod init your-gin-project
   go get github.com/gin-gonic/gin

   Application Code

   Your main.go file should create a Gin server that listens on a port defined by an environment variable. This allows seenode to correctly route traffic to your application.

   main.go

   package main
   
   import "github.com/gin-gonic/gin"
   
   func main() {
       r := gin.Default()
   
       r.GET("/", func(c *gin.Context) {
           c.String(200, "Hello, Welcome to seenode 👋")
       })
   
       r.Run(":80")
   }

   Testing Locally

   You can test your application locally by running:

   go run main.go

2. Deploy on seenode

   Follow these steps to deploy your Gin application:

   1. First, create a new Web Service from the seenode Dashboard and connect your Gin project’s Git repository.
   2. Configure your build and start commands. seenode will attempt to detect these automatically.
      • Build Command:

        go build -o app main.go

      • Start Command:

        ./app

   3. Choose your preferred instance size and create your service.
   4. Watch your deployment progress in real-time through the Logs tab.
   5. Once complete, your Gin application will be accessible via your service’s URL.

   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.

Next Steps

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

Set up a Custom Domain (Coming Soon)

Configure a custom domain to point to your new web service.

Connect to a Database

Instantly scaffold and connect PostgreSQL and MySQL databases