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.
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.
Go to the TrueNAS project on Jira and click Create in the top bar.
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.
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.
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 https://jira.ixsystems.com/projects/NAS/, 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.
We publish previous security reports at https://security.truenas.com/.
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.
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
freenas-debug command-line utility collects debugging information.
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.
Drag and drop public facing files into the Attachment box when creating a new ticket:
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 https://ixsystems.atlassian.net/servicedesk/customer/portal/15/group/37/create/153”. Files uploaded to this service are only visible to project developers. JIRA removes them when closing the ticket.
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
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.
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.