Skip to content
Gin Web Framework

Run multiple service

You can run multiple Gin servers in the same process — each on a different port — by using errgroup.Group from the golang.org/x/sync/errgroup package. This is useful when you need to expose separate APIs (for example, a public API on port 8080 and an admin API on port 8081) without deploying separate binaries.

Each server gets its own router, middleware stack, and http.Server configuration.

package main


import (
  "log"
  "net/http"
  "time"


  "github.com/gin-gonic/gin"
  "golang.org/x/sync/errgroup"
)


var (
  g errgroup.Group
)


func router01() http.Handler {
  e := gin.New()
  e.Use(gin.Recovery())
  e.GET("/", func(c *gin.Context) {
    c.JSON(http.StatusOK, gin.H{
      "code":    http.StatusOK,
      "message": "Welcome server 01",
    })
  })


  return e
}


func router02() http.Handler {
  e := gin.New()
  e.Use(gin.Recovery())
  e.GET("/", func(c *gin.Context) {
    c.JSON(http.StatusOK, gin.H{
      "code":    http.StatusOK,
      "message": "Welcome server 02",
    })
  })


  return e
}


func main() {
  server01 := &http.Server{
    Addr:         ":8080",
    Handler:      router01(),
    ReadTimeout:  5 * time.Second,
    WriteTimeout: 10 * time.Second,
  }


  server02 := &http.Server{
    Addr:         ":8081",
    Handler:      router02(),
    ReadTimeout:  5 * time.Second,
    WriteTimeout: 10 * time.Second,
  }


  g.Go(func() error {
    return server01.ListenAndServe()
  })


  g.Go(func() error {
    return server02.ListenAndServe()
  })


  if err := g.Wait(); err != nil {
    log.Fatal(err)
  }
}

Test it

Terminal window
# Server 01 on port 8080
curl http://localhost:8080/
# Output: {"code":200,"message":"Welcome server 01"}


# Server 02 on port 8081
curl http://localhost:8081/
# Output: {"code":200,"message":"Welcome server 02"}

See also