{"id":1912,"date":"2026-09-05T10:22:34","date_gmt":"2026-09-05T04:52:34","guid":{"rendered":"https:\/\/cpanelfree.com\/blog\/how-to-deploy-golang-gin-fiber-microservices-vps-systemd\/"},"modified":"2026-09-05T12:59:37","modified_gmt":"2026-09-05T07:29:37","slug":"how-to-deploy-golang-gin-fiber-microservices-vps-systemd","status":"publish","type":"post","link":"https:\/\/cpanelfree.com\/blog\/how-to-deploy-golang-gin-fiber-microservices-vps-systemd\/","title":{"rendered":"How to Deploy Go (Golang) Gin and Fiber Microservices on Linux VPS with Systemd"},"content":{"rendered":"

Why Go (Golang) Excels at Cloud Microservices & APIs<\/h2>\n

Created by Google engineers, Go (Golang)<\/strong> was designed from first principles for cloud networking, multi-threaded concurrency, and server-side infrastructure. Unlike interpreted languages requiring complex runtime installations or heavyweight virtual machines, Go compiles directly into a **single, self-contained, statically linked binary** that contains all dependencies and runtime schedulers.<\/p>\n

High-speed Go web frameworks like Fiber<\/strong> (built on FastHTTP) and Gin<\/strong> leverage Go’s lightweight **Goroutines** (which consume only 2KB of initial stack memory compared to 1MB+ for OS threads), allowing a single modest VPS to effortlessly manage tens of thousands of concurrent WebSocket and REST API connections.<\/p>\n

In this technical tutorial, we will configure the latest Go compiler on Ubuntu 24.04\/22.04 LTS, build a production Fiber API microservice, supervise the binary with systemd, and configure an Nginx reverse proxy with SSL encryption.<\/p>\n

Step 1: Installing the Official Go Compiler on Ubuntu VPS<\/h2>\n

Install the latest official Go release tarball directly from Google’s distribution server:<\/p>\n

# Remove old versions and download latest Go 1.22\nsudo rm -rf \/usr\/local\/go\ncd \/tmp\ncurl -LO https:\/\/go.dev\/dl\/go1.22.6.linux-amd64.tar.gz\n\n# Extract binary to \/usr\/local\nsudo tar -C \/usr\/local -xzf go1.22.6.linux-amd64.tar.gz\n\n# Configure system-wide environment PATH\necho 'export PATH=$PATH:\/usr\/local\/go\/bin' | sudo tee -a \/etc\/profile\nsource \/etc\/profile\n\n# Confirm Go compiler version\ngo version<\/code><\/pre>\n
Step 2: Initializing the Go Microservice Project<\/h2>\n
Create a dedicated workspace directory and initialize a Go module:<\/p>\n
# Create project directory\nsudo mkdir -p \/var\/www\/go-microservice\nsudo chown -R $USER:$USER \/var\/www\/go-microservice\ncd \/var\/www\/go-microservice\n\n# Initialize Go module\ngo mod init go-microservice\n\n# Install Fiber v2 web framework\ngo get github.com\/gofiber\/fiber\/v2<\/code><\/pre>\n
Create the production API entrypoint at \/var\/www\/go-microservice\/main.go<\/code>:<\/p>\n
package main\n\nimport (\n    \"log\"\n    \"time\"\n    \"github.com\/gofiber\/fiber\/v2\"\n    \"github.com\/gofiber\/fiber\/v2\/middleware\/compress\"\n    \"github.com\/gofiber\/fiber\/v2\/middleware\/cors\"\n    \"github.com\/gofiber\/fiber\/v2\/middleware\/logger\"\n    \"github.com\/gofiber\/fiber\/v2\/middleware\/recover\"\n)\n\ntype ApiResponse struct {\n    Status    string `json:\"status\"`\n    Message   string `json:\"message\"`\n    Timestamp int64  `json:\"timestamp\"`\n}\n\nfunc main() {\n    app := fiber.New(fiber.Config{\n        Prefork:       false,\n        ServerHeader:  \"CpanelFree-Go-Engine\",\n        StrictRouting: true,\n        CaseSensitive: true,\n    })\n\n    \/\/ Production Middlewares\n    app.Use(recover.New())\n    app.Use(logger.New())\n    app.Use(compress.New(compress.Config{Level: compress.LevelBestSpeed}))\n    app.Use(cors.New())\n\n    \/\/ Health Check Endpoint\n    app.Get(\"\/health\", func(c *fiber.Ctx) error {\n        return c.Status(fiber.StatusOK).JSON(ApiResponse{\n            Status:    \"healthy\",\n            Message:   \"Go microservice executing with sub-millisecond response time\",\n            Timestamp: time.Now().Unix(),\n        })\n    })\n\n    log.Println(\"Go Fiber Microservice listening on 127.0.0.1:8080...\")\n    log.Fatal(app.Listen(\"127.0.0.1:8080\"))\n}<\/code><\/pre>\n
Step 3: Compiling Statically Linked Production Binary<\/h2>\n
Compile a stripped, standalone production binary with debug symbols removed:<\/p>\n
# Compile production binary with optimizations (-s -w strips debug symbols)\nCGO_ENABLED=0 GOOS=linux go build -ldflags=\"-s -w\" -o \/usr\/local\/bin\/go-api main.go\n\n# Verify file size and executable permissions\nls -lh \/usr\/local\/bin\/go-api\nsudo chmod +x \/usr\/local\/bin\/go-api<\/code><\/pre>\n
Step 4: Supervising the Binary with Systemd Daemon<\/h2>\n
Create \/etc\/systemd\/system\/go-api.service<\/code>:<\/p>\n
[Unit]\nDescription=Go Fiber Production Microservice\nAfter=network.target\n\n[Service]\nUser=www-data\nGroup=www-data\nType=simple\nExecStart=\/usr\/local\/bin\/go-api\nRestart=always\nRestartSec=3\nLimitNOFILE=65535\n\n[Install]\nWantedBy=multi-user.target<\/code><\/pre>\n
Start and enable the systemd daemon:<\/p>\n
sudo systemctl daemon-reload\nsudo systemctl enable --now go-api\nsudo systemctl status go-api --no-pager<\/code><\/pre>\n
Step 5: Nginx Reverse Proxy with SSL<\/h2>\n
Configure Nginx at \/etc\/nginx\/sites-available\/go-api.example.com<\/code>:<\/p>\n
server {\n    listen 80;\n    server_name go-api.example.com;\n\n    location \/ {\n        proxy_pass http:\/\/127.0.0.1:8080;\n        proxy_http_version 1.1;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n    }\n}<\/code><\/pre>\n
Enable the site and issue an SSL certificate:<\/p>\n
sudo ln -s \/etc\/nginx\/sites-available\/go-api.example.com \/etc\/nginx\/sites-enabled\/\nsudo nginx -t && sudo systemctl reload nginx\nsudo certbot --nginx -d go-api.example.com<\/code><\/pre>\n
Building Asynchronous Database Connection Pools with pgx<\/h2>\n
For maximum SQL performance and low-overhead binary protocol communication, connect Go microservices to PostgreSQL using the official pgx<\/strong> driver pool:<\/p>\n
package main\n\nimport (\n    \"context\"\n    \"log\"\n    \"github.com\/jackc\/pgx\/v5\/pgxpool\"\n)\n\nvar dbPool *pgxpool.Pool\n\nfunc initDB() {\n    config, err := pgxpool.ParseConfig(\"postgres:\/\/app_user:SecretPass2026!@127.0.0.1:5432\/app_prod?sslmode=disable\")\n    if err != nil {\n        log.Fatalf(\"Unable to parse database config: %v\", err)\n    }\n    config.MaxConns = 25\n    config.MinConns = 5\n\n    dbPool, err = pgxpool.NewWithConfig(context.Background(), config)\n    if err != nil {\n        log.Fatalf(\"Unable to connect to database: %v\", err)\n    }\n}<\/code><\/pre>\n
Go Production Tuning & Garbage Collection Optimizations<\/h2>\n
Fine-tune Go’s memory ballasts and garbage collector target percentages using environment variables:<\/p>\n
# Set GOGC to 100 or 200 in systemd service to balance memory vs CPU cycles\nEnvironment=\"GOGC=150\"\nEnvironment=\"GOMAXPROCS=4\"<\/code><\/pre>\n
Go Microservice Operational Checklist<\/h2>\n