TrueNAS CORE Community Release Documentation
This content documents the end of life 13.3 TrueNAS Community release. Archival documentation is provided for reference only and not actively maintained. Use the Product and Version selectors above to view content specific to another TrueNAS release.
Getting Support
4 minute read.
There are several options to get support for your TrueNAS installation. TrueNAS CORE users can engage with the TrueNAS community to answer questions and resolve issues. TrueNAS Enterprise hardware customers can also access the fast and effective support directly provided by iXsystems.
TrueNAS CORE users are welcome to report bugs and vote for or suggest new TrueNAS features in the project Jira instance. Have questions? We recommend searching through the software documentation and community resources for answers.
If you encounter a bug or other issue while using TrueNAS, create a bug report in the TrueNAS Jira Project. The web interface provides a form to report issues without logging out. We recommend searching the project first to see if another user already reported the issue. You must have a Jira account to create a bug ticket.
To report an issue using the web interface, go to System > Support.
Enter your Jira Username and Password to verify your account credentials and unlock the SUBMIT button. The Category dropdown has a large number of options. Choose the category that best fits where you encountered the issue.
Attaching a debug file and screenshot(s) to your bug ticket is generally recommended to help find the bug and speed up response. Select Attach Debug to automatically generate a new debug and privately attach it to the issue. Private debug attachments are only visible to iXsystems engineering staff.
Keep the Subject brief and informative. Having a short, descriptive subject allows the community to easily find and respond to your issue. The Description should contain more details about the problem. We recommend keeping the description less than three paragraphs and including any steps to reproduce the issue.
The TrueNAS web interface lets users save debugging information to a text file.
On TrueNAS CORE systems, go to System > Advanced and click SAVE DEBUG.
Click PROCEED to generate the debug file (might take a few minutes).
After generating the debug file, TrueNAS prompts you to download it to your local system and saves a copy in
The
freenas-debug
command-line utility collects debugging information.
Debug files contain log files which can include personal information such as usernames, networking configuration, device serial numbers, or other identifying information about your system. Files uploaded to an issue from the System > Support screen using Attach Debug or through the Jira Private File Upload service are only visible to iXsystems engineers. The iXsystems Privacy Policy contains a detailed statement of our commitment to data privacy.
Always store debug files in a secure location. Please review debugs and redact any sensitive information before sharing with external entities. Use a file archiver utility, such as 7-zip, to open compressed debug archives and review log contents.
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://ixsystems.atlassian.net/projects/NAS/, log in to your Jira account, and click Create.
Briefly describe the new feature you would 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.
The TrueNAS Community is an active online resource for asking questions, troubleshooting issues, and sharing information with other TrueNAS users. You must register to post.
We encourage new users to briefly review the forum rules and helpful tips before posting.
Community Resources are user-contributed articles about every facet of using TrueNAS. They are organized into broad categories and incorporate a community rating system to better highlight content that the whole community has found helpful.
You are always welcome to network with other TrueNAS users using the various social media platforms!