Skip to content

Manage your Buf account#

A Buf account on buf.build lets you authenticate the CLI and API, create and manage organizations and repositories, push modules, and access private resources. Browsing public modules doesn’t require an account.

This page covers personal account management. For shared automation on a private BSR instance, prefer a bot user over a personal account.

Sign up#

Sign up with Google, GitHub, or an email-and-password combination. The BSR sends a verification email; click the link inside to verify the address. After verification, choose a username to complete registration. Once registered, the username appears in the upper right-hand corner of the BSR.

Update your profile#

On the settings page, you can add a profile URL (any valid URI, up to 255 characters) and a description (up to 350 characters).

API tokens#

API tokens authenticate the CLI and other tools as your user. All user tokens are equivalent bearer tokens; there are no scopes or finer-grained permissions today.

To create a token:

  1. On the settings page, click Create new token.
  2. Choose an expiration: Never, 1 month, 1 year, or Custom.
  3. Add a note to distinguish this token from others.
  4. Click Create and copy the token immediately. The BSR doesn’t show the token again, and anyone holding it can act as your user, so store it somewhere safe.

For full token usage, including environment variables and .netrc setup, see Authentication.

Reset your password#

Password reset applies only to email-and-password accounts. If you signed up with Google or GitHub, reset your password with that provider; the BSR doesn’t manage credentials for SSO accounts.

To reset a password on an email-and-password account:

  1. Click Forgot password? on the login page.
  2. Enter your email address.
  3. Follow the instructions in the password-reset email you receive.

After the reset succeeds, the BSR sends a confirmation email.

Delete your account#

Warning

Deleting your account is permanent and can’t be undone. Before you can delete the account, you must delete every repository and plugin you own, and leave or delete every organization you belong to.

To delete the account, open the settings page and click Delete account.