Get a Quote     (408) 943-4100               TrueNAS Discord      VendOp_Icon_15x15px   Commercial Support Toggle between Light and Dark mode

Issue Reporting

  5 minute read.

Last Modified 2022-12-02 13:57 EST

We encourage all users to help us make TrueNAS the best NAS by reporting issues, requesting potentially helpful features, and relaying security vulnerabilities.

Issue Reporting

iXsystems uses Jira to track bugs and develop features. You can view public issues without logging in, but you must create a Jira account to report bugs or suggest features.

TrueNAS Jira Project

Bug Reports

Go to the TrueNAS project on Jira and click Create in the top bar.

Create Ticket

Set the Issue Type to Bug. The form reloads with more fields. Developers use most of them, but you should fill out the Summary and Description to provide a useable report.

The Summary is a short, descriptive title that helps developers find the issue and understand the topic.

The Description lets you enter specific issue details.


A good bug report includes these elements:

  • A brief, specific, description detailing the problem you encountered.

  • Steps to reproduce the issue. A simple list of the steps you took to see the issue is fine.

  • An explaination of what should have happened while taking the steps listed above.

  • A description of what actually happened while taking the steps listed above.

  • Your TrueNAS software version (found in Dashboard).

  • If the bug is service-related, include the current service configuration to help developers replicate your system.

  • Always include a TrueNAS Debug file. Include a console log if the error is a web interface issue. If unsure how to save these, refer to the TrueNAS Debug and Web Console Log tabs on this page.

  • Include screenshots if the bug is a web interface glitch or a formatting problem.

  • Include a video if screenshots do not adequately show the issue.

  • Include additional details you think can help the developer investigate.

When finished filling out the Description, click Create at the bottom of the form.

Submit Ticket

Developers review and update the ticket if/when they need additional information. The Jira account receives emails about the ticket status. Developers may request more details as they work to resolve the issue, so check the ticket periodically.

Feature Suggestions

Want to see a new feature added to TrueNAS? You can see and vote for community-proposed features in the TrueNAS Jira project and make your feature suggestions here. If you find a suggestion that you want to see implemented, open that ticket and click Vote for this issue in the People section.


To suggest a new feature, go to, log in to your Jira account, and click Create.


Briefly describe the new feature you’d like to see added in the Summary section. After creating your feature suggestion, it moves to the Gathering Interest stage, where the community can review and vote for the feature. After gathering enough interest, the TrueNAS Release Council reviews the suggestion for feasibility and determines where to add the feature in the software roadmap.

Security Issues

We publish previous security reports at

Security issues do not appear on public issue trackers due to their sensitive nature. If you have discovered a suspected security vulnerability in the latest version of a software release, you can report this directly to the Security Team.

Creating a Debug File

The TrueNAS web interface lets users save debugging information to a text file.

Go to System > Advanced and click SAVE DEBUG. Click PROCEED to generate the debug file (may take a few minutes). After generating the debug file, TrueNAS prompts you to download it to your local system and saves a copy in /var/tmp/fndebug.

The freenas-debug command-line utility collects debugging information.

Adding a Debug File to a Report

Jira provides a public facing area for files that do not require privacy. There is also a secure, developer only, area for uploading files with sensitive information like a system debug.

New Tickets

Drag and drop public facing files into the Attachment box when creating a new ticket:


Existing Tickets

For public facing files, open the ticket in your browser and either click Attach, at the top of the ticket, or click the +, in the Attachments section, to open a local system file browser to select the files. You can also drag and drop the file onto the Attacments box and add any comments about it.

Upload private files to our secure private upload service located at”. Files uploaded to this service are only visible to project developers. JIRA removes them when closing the ticket.

Web Console Log

Web console logs help diagnose problems with the user interface. You can add logs to TrueNAS issues for debugging.


Open the web console by clicking (Menu) > More Tools > Web Developer Tools (Ctrl-Shift-I).

In the upper right, set Persist Logs. Click (More) > Settings. In the Web Console section, set Enable timestamps.

Select the Console tab, then click (Settings) and set Show Timestamps and Persist Logs.

Leave the console open and perform the action that encounters problems. Right-click in the console window and select Export Visible Messages To > Clipboard. Open an editor, paste the clipboard contents, and save to a new console.log file.

After saving the file, open the console with (Menu) > More Tools > Web Developer Tools (Ctrl-Shift-I) and unset Persist Logs.


Open the console by clicking (Options) > More Tools > Developer tools (Ctrl-Shift-I).

Click (Preferences) and set Preserve log and Show timestamps. Close the Preferences window.

Leave the console open and perform the action that encounters problems. Right-click the console window. Choose Save as… and save the file.

After saving the file, open the console with (Options) > More Tools > Developer tools (Ctrl-Shift-I) and unset Preserve log.

Attaching a Console Log File to a Report

Go to the iXsystems Bug Tracker. Locate an existing ticket or create a new one reporting the problem. Attach the console log file to the ticket by dragging it to Attachments.

Related Content