# Biobakery Workflow database

**URL:** <https://forum.biobakery.org/t/biobakery-workflow-database/4791>\
**Category:** bioBakery workflows\
**Created:** [February 13, 2023, 7:07am UTC](https://forum.biobakery.org/t/biobakery-workflow-database/4791 "2023-02-13T07:07:57Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![chansamuel](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/chansamuel/32/1771_2.png) [@chansamuel](https://forum.biobakery.org/u/chansamuel)\
**Post date:** [February 13, 2023, 7:07am UTC](https://forum.biobakery.org/t/biobakery-workflow-database/4791/1 "2023-02-13T07:07:57Z")

</div>

Hi, so I’m having bit of an issue using biobakery workflow. The main issue is that the database (for wgmx) is stored in a different path due to memory related reasons. How do I make biobakery workflow use the database stored elsewhere?

---

<div class="post-metadata">

**Author:** ![lauren.j.mciver](https://avatars.discourse-cdn.com/v4/letter/l/f05b48/32.png) [@lauren.j.mciver](https://forum.biobakery.org/u/lauren.j.mciver)\
**Post date:** [March 17, 2023, 2:23pm UTC](https://forum.biobakery.org/t/biobakery-workflow-database/4791/2 "2023-03-17T14:23:30Z")

</div>

Hello, You can set environment variables to point to databases that are in a custom location.

If all databases are under one custom folder set the variable: `$BIOBAKERY_WORKFLOWS_DATABASES` .

Alternatively if you have multiple custom folders, then set one or more of the environment variables:  
`$KNEADDATA_DB_HUMAN_GENOME, $KNEADDATA_DB_RIBOSOMAL_RNA, $KNEADDATA_DB_HUMAN_TRANSCRIPTOME, $STRAINPHLAN_DB_REFERENCE, and $STRAINPHLAN_DB_MARKERS`.

If your HUMAnN databases are stored in a custom folder the HUMAnN configuration file gets updated when you select the folder and download the database through the HUMAnN database tool so there is nothing you would need to do. If your MetaPhlAn database is installed in a custom folder you would need to provide that location as a `--metaphlan-option` with the `--index` option when running the workflow.

Please post if you have additional questions or are still running into issues.

Thanks!  
Lauren

---

<div class="post-metadata">

**Author:** ![Arya](https://avatars.discourse-cdn.com/v4/letter/a/a4c791/32.png) [@Arya](https://forum.biobakery.org/u/Arya)\
**Post date:** [August 28, 2023, 7:26pm UTC](https://forum.biobakery.org/t/biobakery-workflow-database/4791/3 "2023-08-28T19:26:15Z")

</div>

Hi Lauren,  
Just a followup to this.

Does running the below code install all needed and updated databases (ie if we were to run Metaphlan 4 through the workflow and wanted the updated databases)?  
$ biobakery\_workflows\_databases --install wmgx ’

Or do we need to download the individual databases and provide location?

---

<div class="post-metadata">

**Author:** ![lauren.j.mciver](https://avatars.discourse-cdn.com/v4/letter/l/f05b48/32.png) [@lauren.j.mciver](https://forum.biobakery.org/u/lauren.j.mciver)\
**Post date:** [August 30, 2023, 7:20pm UTC](https://forum.biobakery.org/t/biobakery-workflow-database/4791/4 "2023-08-30T19:20:51Z")

</div>

Hi Arya, Yes that should install all the required databases for the wmgx workflow except MetaPhlAn. The MetaPhlAn database will be installed the first time you run it. Alternatively, you can install that database by running `$ metaphlan --install`.

Thanks!  
Lauren

---

<div class="post-metadata">

**Author:** ![Brycealong](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/brycealong/32/3575_2.png) [@Brycealong](https://forum.biobakery.org/u/Brycealong)\
**Post date:** [February 24, 2026, 6:13pm UTC](https://forum.biobakery.org/t/biobakery-workflow-database/4791/5 "2026-02-24T18:13:32Z")

</div>

Hi Lauren,

Following up on this thread — I manually downloaded the databases and organized them under a single parent directory (biobakery\_workflows\_databases/) with the following structure:

 ![Screenshot 2026-02-23 at 10.09.16 PM](https://canada1.discourse-cdn.com/flex027/uploads/biobakery/original/2X/0/04147801f60b6103d8e746130f36cd1682feb0c5.png)

I’m planning to export the `$BIOBAKERY_WORKFLOWS_DATABASES` environment variable pointing to this parent directory. For MetaPhlAn I have multiple database versions (v20 and vJan21). For KneadData, I’m using a mouse reference (mouse\_C57BL) rather than the human genome and it’s in it’s subdirectory.

My question:

Is this folder structure what the workflow expects when using `$BIOBAKERY_WORKFLOWS_DATABASES`, or do the subdirectory names need to match a specific convention? Or in this case the only way is to export different environment variables?

Thanks!