Quickstart: Deploy a Fiber App

This guide explains how to deploy a Fiber application to seenode. Fiber is an Express-inspired web framework built on top of Fasthttp, the fastest HTTP engine for Go.

Deploy a Fiber Template

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

Fiber Template

Deploy a minimal Fiber application designed for zero-configuration deployment.

Deploying an Existing Fiber Project

Follow these steps to prepare and deploy your Fiber project.

Prerequisites

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

Don’t have a project yet?

You can fork our Fiber 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 Fiber project contains a main.go entry point and a go.mod file.

   • Directoryyour-fiber-project/

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

   Dependencies

   Make sure your go.mod lists gofiber/fiber as a dependency.

   go.mod

   module your-fiber-project
   
   go 1.21
   
   require github.com/gofiber/fiber/v2 v2.52.0

   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 Fiber 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-fiber-project
   cd your-fiber-project
   go mod init your-fiber-project
   go get github.com/gofiber/fiber/v2

   macOS

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

   Windows

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

   Application Code

   Your main.go file should create a Fiber 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/gofiber/fiber/v2"
   
   func main() {
       app := fiber.New()
   
       app.Get("/", func(c *fiber.Ctx) error {
           return c.SendString("Hello, Welcome to seenode 👋")
       })
   
       app.Listen(":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 Fiber application:

   1. First, create a new Web Service from the seenode Dashboard and connect your Fiber 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 Fiber 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 Fiber 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