# Reporting a Bug

## Bug Tracker <a href="#bug-tracker" id="bug-tracker"></a>

For reporting any kind of bugs, use the [GitHub issue tracker](https://github.com/LMMS/lmms/issues). Please take a look at other [submitted bugs](https://github.com/LMMS/lmms/issues) before opening a new item as someone else might have reported the same bug.

## Reporting Bugs with `gdb` <a href="#gdb" id="gdb"></a>

If you are using LMMS and encounter a segmentation fault (crash), please include a full backtrace:

{% tabs %}
{% tab title="Linux" %}

```
gdb /usr/bin/lmms
r
```

Then attempt to replicate the crash. Once LMMS crashes:

```
thread apply all backtrace
```

{% endtab %}
{% endtabs %}

The output of this command is interesting for us! Please either report it to the [issue tracker](https://github.com/LMMS/lmms/issues) or email it to the [mailing list](http://lists.sourceforge.net/lists/listinfo/lmms-devel).

## How to Report Bugs without GDB <a href="#reporting-bugs-without-gdb" id="reporting-bugs-without-gdb"></a>

{% tabs %}
{% tab title="Linux" %}

```
$ ulimit -l unlimited
$ lmms
```

Now when LMMS crashes, there will be a file called "core" in your working directory. The file may be large enough to be worth zipping.
{% endtab %}
{% endtabs %}
