> 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/on-instrument-analysis-software/software-on-instrument-analysis-software-troubleshooting-list/000007055.md).

# Creating a custom DRAGEN reference genome for NextSeq1000/2000 analysis

**Creating a custom DRAGEN reference hash table/genome for NextSeq1000/2000 analysis**

● DRAGEN requires reference genomes to be converted into a **hash table** format.

● On the NextSeq 1000/2000, the pre-loaded genomes are already converted to hash tables.

● To use a custom reference genome for NextSeq1000/2000, use the **BSSH Reference Builder (Instruments)** app to convert a reference genome in FASTA format to a hash table.

For custom genomes, we recommend using GTF files (& genomes) from [Ensembl](http://useast.ensembl.org/info/data/ftp/index.html/)

To upload FASTQ/GTF files to BaseSpace Sequence Hub (BSSH), open a project, click the File icon, and select Upload > Files > Misc/Others

![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-230d740f107323d87dc18f36b21cf21a48b6dd33%2Fimage1.png?alt=media\&token=0cc6b915-2314-40ff-ba5f-b05a405853e2)

**Reference Builder for Illumina Instruments app input files:**

Reference genome in FASTA format - the file must use extension .fasta or .fa.

Gene annotation file in GTF format - the file must be gzipped and must use the extension gtf.gz.

Custom genomes built using the BSSH Reference Builder (Instrument) app are available in the BSSH Run Planning Reference Genome menu under Analysis Setting.\
After running the BSSH Reference Builder (Instrument) app, the custom genome is ready for use in **Cloud** analysis.

![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-f1a329b371ea4608b89f7d4e9992fcf5af1b4ac6%2Fimage2.png?alt=media\&token=edcf71e8-ed57-4de5-b81f-7a4a0e861d0a)

To use a custom genome for **Local** analysis, the genome must be imported on-instrument through the NextSeq 1000/2000 Control Software.

The output of the BSSH Reference Builder for Illumina Instruments app is a \*.tar.gz file.

Download the \*.tar.gz file and import it through the NextSeq 1000/2000 Control Software.

**Importing a custom genome:**

You must be logged in as ilmnadmin to import genomes.

![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-a1dda13b99afb6716ec086ee530f2ef5c26efddc%2Fimage3.png?alt=media)

After import, the custom genome is found in the genome repository:

/usr/local/illumina/genomes

\
\
\ <br>

|                                                                                                                                                                                                                                                                                                                                                                 |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| *For any feedback or questions regarding this article (Illumina Knowledge Article #7055), contact Illumina Technical Support* [*techsupport@illumina.com*](mailto:techsupport@illumina.com?subject=Question%2FFeedback%20Regarding%20Illumina%20Knowledge%20Article%20#000007055%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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://knowledge.illumina.com/software/on-instrument-analysis-software/software-on-instrument-analysis-software-troubleshooting-list/000007055.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
