> ## Documentation Index
> Fetch the complete documentation index at: https://bun.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Feedback

> Share feedback, bug reports, and feature requests

Here's how to open a helpful issue for a bug, a performance problem, or a feature request:

For general questions, join the [Discord](https://bun.com/discord).

## Reporting Issues

**1. Upgrade Bun**

Upgrade Bun to the latest version with `bun upgrade`. This might fix your problem without opening an issue.

```bash terminal icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}}
bun upgrade
```

You can also try the latest canary release, which includes changes and bug fixes that haven't reached a stable release yet.

```bash terminal icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}}
bun upgrade --canary

# To revert to the stable release
bun upgrade --stable
```

If the issue persists after upgrading, continue to the next step.

**2. Review Existing Issues**

Check whether the issue has already been reported before opening a new one. Checking first saves time for everyone and helps us focus on fixing things.

* 🔍 [**Search existing issues**](https://github.com/oven-sh/bun/issues)
* 💬 [**Check discussions**](https://github.com/oven-sh/bun/discussions)

If you find a related issue, add a 👍 reaction or comment with extra details instead of opening a new one.

**3. Report the Issue**

If no one has reported the issue, open a new one or suggest an improvement.

* 🐞 [**Report a Bug**](https://github.com/oven-sh/bun/issues/new?template=2-bug-report.yml)
* ⚡ [**Suggest an Improvement**](https://github.com/oven-sh/bun/issues/new?template=4-feature-request.yml)

Provide as much detail as possible, including:

* A clear and concise title
* A code example or steps to reproduce the issue
* The version of Bun you are using (run `bun --version`)
* A description of the issue (what you expected to happen and what actually happened)
* The operating system and version you are using
  > [!NOTE]
  >
  > * For macOS and Linux: copy the output of `uname -mprs`
  > * For Windows: copy the output of this command in the PowerShell console:
  >   `"$([Environment]::OSVersion | ForEach-Object VersionString) $(if ([Environment]::Is64BitOperatingSystem) { "x64" } else { "x86" })"`

The Bun team will review the issue and get back to you as soon as possible.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.