---
name: "buf-config-init"
section: "1"
platform: "linux"
package: "buf"
version: "1.75.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/buf-config-init"
---

# buf-config-init(1)

Initialize buf configuration files for your local development

## NAME

buf-config-init - Initialize buf configuration files for your local development

## SYNOPSIS

**buf config init \[buf.build/owner/foobar\] \[flags\]**

## DESCRIPTION

This command will write a new buf.yaml file to start your local development.

If a buf.yaml already exists, this command will not overwrite it, and will produce an error.

The effects of this command may change over time - this command may initialize i.e. buf.gen.yaml files in the future.

## OPTIONS

**-h**, **--help**\[=false\]\
 	help for init

**-o**, **--output**="."\
 	The directory to write the configuration files to

## OPTIONS INHERITED FROM PARENT COMMANDS

**--debug**\[=false\]\
 	Turn on debug logging (env BUF\_DEBUG)

**--log-format**="color"\
 	The log format text,color,json ⟨env BUF\_LOG\_FORMAT⟩

**--timeout**=0s\
 	The duration until timing out, setting it to 0 means no timeout (env BUF\_TIMEOUT)

## SEE ALSO

**[buf-config(1)](/buf-config/1.md)**

## HISTORY

2026-10-22 Auto generated by spf13/cobra