Graceful Shutdown

Lightning provides two ways to start your server: app.Run() for simple cases and app.RunGraceful() when you need to finish in-flight requests before the process exits.

`app.Run()`

app.Run() starts the server and blocks until the server encounters an error. Pass an address string to bind to a specific host and port.

app.Run(":8080")           // listen on all interfaces, port 8080
app.Run("127.0.0.1:9000") // listen on localhost only

When you call app.Run() with no arguments, the server listens on :6789 by default. You can also override the port by setting the PORT environment variable.

app.Run() does not handle OS signals. Sending SIGINT (Ctrl+C) or SIGTERM terminates the process immediately without waiting for active connections to complete.

`app.RunGraceful()`

app.RunGraceful(shutdownTimeout, address) listens for SIGINT and SIGTERM. When either signal arrives, it calls the underlying server’s shutdown method and waits up to shutdownTimeout seconds for active connections to finish.

app.RunGraceful(10, ":8080") // 10-second shutdown window

If shutdownTimeout is zero or negative, it defaults to 5 seconds. Like app.Run(), the address argument is optional — omit it to fall back to :6789.

`app.Shutdown()`

Call app.Shutdown() to trigger a graceful shutdown programmatically (for example, from a signal handler you manage yourself or from a test).

app.Shutdown()

Calling Shutdown() before the server has started is a no-op.

Complete Example

package main

import (
    "github.com/go-labx/lightning"
)

func main() {
    app := lightning.DefaultApp()

    app.Get("/ping", func(ctx *lightning.Context) {
        ctx.JSON(lightning.StatusOK, lightning.Map{"message": "pong"})
    })

    // Start with a 10-second graceful shutdown window.
    // Blocks until SIGINT or SIGTERM is received, then waits up to
    // 10 seconds for in-flight requests to complete.
    if err := app.RunGraceful(10, ":8080"); err != nil {
        app.Logger.Warn("server error: %v", err)
    }
}

When you stop the process with Ctrl+C or kill <pid>, you will see:

Received signal interrupt, shutting down gracefully...
Server stopped gracefully

Prefer RunGraceful in production so that long-running requests (database queries, file uploads) are not cut off mid-flight during deployments or container restarts.

Get Started

Core Concepts

Guides

Configuration

`app.Run()`

`app.RunGraceful()`

`app.Shutdown()`

Complete Example

​app.Run()

​app.RunGraceful()

​app.Shutdown()

​Complete Example

`app.Run()`

`app.RunGraceful()`

`app.Shutdown()`

Complete Example