> For the complete documentation index, see [llms.txt](https://knowledge.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.illumina.com/software/general/software-general-troubleshooting-list/000007488.md).
# Creating custom reference genomes (non human) to use with DRAGEN apps on BaseSpace Sequence Hub
DRAGEN requires reference genomes to be converted into a **hash table** format.
To use a custom reference genome (non-human) with DRAGEN apps in BaseSpace Sequence Hub (BSSH), use the [DRAGEN Reference Builder app](https://basespace.illumina.com/apps/18468450/DRAGEN-Reference-Builder?preferredversion=)(consideration depends on which DRAGEN App(s) versions will be used for analysis) to convert a reference genome in FASTA format to a hash table. User is recommended to check the App Description of intended application for the requirement of the custom hash table.
Table listing recommended DRAGEN Reference Builder app version for different major DRAGEN versions
DRAGEN version
Hash table version
DRAGEN Reference Builder app version
4.5
12
4.5.4000
4.4
11
4.4.6002
4.3
10
4.3.6002
4.2
9
4.2.4002
3.5 - 4.1
8
3.7.8802
Once the DRAGEN Reference Builder app has built a custom hash table, use DRAGEN apps with 'Custom' Reference option.
The DRAGEN apps typically provide built-in support for hg19, hg38, CHM13, and hs37d5. The DRAGEN Reference Builder app is meant for users who need to generate a custom, non-human or non-standard reference.
**Where to download the FASTA/GTF file?**
For custom genomes for RNA analysis, Illumina recommends using GTF files (& genomes) from [Ensembl.](https://useast.ensembl.org/info/data/ftp/index.html/) Additionally mm9, mm39 and rn6 references are available by default for the latest DRAGEN Single Cell RNA and DRAGEN RNA applications.
Users can also download FASTA file from public databases or from [iGenomes](https://support.illumina.com/sequencing/sequencing_software/igenome.html).
**How to upload the fasta/GTF files to BaseSpace?**
To upload FASTA/GTF files to BaseSpace Sequence Hub (BSSH): open a project, select the **File** icon, then select **Upload** > **Files** > **Misc .** Alternatively such files can be uploaded using [BaseSpace](https://developer.basespace.illumina.com/docs/content/documentation/cli/cli-examples#Uploadingarbitrarydata) [CLI](https://developer.basespace.illumina.com/docs/content/documentation/cli/cli-examples#Uploadingarbitrarydata) or API.
The FASTA file extension must be either **.fasta** or **.fa** or the apps will not recognize it.The GTF file extension must beeither **.gtf** or **.gtf.gz** or the apps will not recognize it.
\
\
\
| |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| *For any feedback or questions regarding this article (Illumina Knowledge Article #7488), contact Illumina Technical Support* [*techsupport@illumina.com*](mailto:techsupport@illumina.com?subject=Question%2FFeedback%20Regarding%20Illumina%20Knowledge%20Article%20#000007488%20-%20Software%20\&body=Dear%20Illumina%20Technical%20Support,%0D%0A%0D%0A)*.* |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://knowledge.illumina.com/software/general/software-general-troubleshooting-list/000007488.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.