gofasta dev

Starts the development server with automatic hot reload powered by Air . When you change any .go file, the server automatically rebuilds and restarts, giving you a fast feedback loop during development.

Usage

gofasta dev [flags]

Run this command from the root directory of your Gofasta project.

Flags

Examples

Start the dev server with default settings:

gofasta dev

Start on a custom port:

gofasta dev --port 3000

Start on localhost only (not exposed to the network):

gofasta dev --host 127.0.0.1

Start without hot reload:

gofasta dev --no-reload

Combine flags:

gofasta dev -p 9090 -H 127.0.0.1

How It Works

The gofasta dev command wraps the Air  live reloader. When you run it:

1. Air watches all .go files in your project for changes
2. On any file change, it rebuilds the binary
3. The previous server process is stopped
4. The new binary is started automatically

The Air configuration is stored in .air.toml at the project root. You can customize watched directories, excluded paths, build commands, and delay settings by editing this file.

Available Endpoints

Once the dev server is running, the following endpoints are available:

Replace 8080 with your custom port if you used the --port flag.

Using Docker

If you prefer running inside Docker with hot reload, use the provided Makefile command instead:

make dev

This starts the Docker Compose development profile, which includes both the application with Air hot reload and the database service.

Troubleshooting

Port already in use — If you see bind: address already in use, another process is using the port. Either stop that process or use a different port with --port.

Air not found — The gofasta dev command handles Air internally. If you encounter issues, make sure you have run gofasta init to install all dependencies.

Related

• gofasta serve — start the production server
• gofasta new — create a new project
• Quick Start