# HUMAnN3 v3.7 database error "Please install the latest version of the database: 201901b"

**URL:** <https://forum.biobakery.org/t/humann3-v3-7-database-error-please-install-the-latest-version-of-the-database-201901b/5459>\
**Category:** HUMAnN\
**Created:** [June 13, 2023, 7:36am UTC](https://forum.biobakery.org/t/humann3-v3-7-database-error-please-install-the-latest-version-of-the-database-201901b/5459 "2023-06-13T07:36:54Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![fboulund](https://avatars.discourse-cdn.com/v4/letter/f/ebca7d/32.png) [@fboulund](https://forum.biobakery.org/u/fboulund)\
**Post date:** [June 13, 2023, 7:36am UTC](https://forum.biobakery.org/t/humann3-v3-7-database-error-please-install-the-latest-version-of-the-database-201901b/5459/1 "2023-06-13T07:36:54Z")

</div>

**Edit: I figured out what was wrong. I managed to get it running in a clean conda environment. I was initially trying using a new singularity image I had built, but singularity used an old cached copy of an older version of the container based on the same singularity deffile. Problem solved!**

Leaving the rest of the post here in case it helps someone else in the future. I still find the naming conventions of the HUMAnN databases confusing, but it appears it was not the databases that were the issue this time.

I’m having trouble running HUMAnN3 v3.7 with the latest database versions available.

Hoping someone can help me figure what I’m doing wrong. I have read all the other threads I have found about HUMAnN3 and database issues, but nothing seems directly similar to my problem.

When I run HUMAnN3 v3.7 using what I think are the latest databases:

- chocophlan\_v201901\_v31
- uniref90\_201901b\_full

I get the following error message:

`CRITICAL ERROR: The directory provided for ChocoPhlAn contains files (g __candidate_division_Zixibacteria_unclassified.s__ candidate_division_Zixibacteria_bacterium_HGW_Zixibacteria_1.centroids.v201901_v31.ffn.gz) that are not of the expected version. Please install the latest version of the database: 201901b`

I thought chocophlan v201901\_v31 was the latest?

The official database download tool `humann_databases` lists the following:

> $ humann\_databases  
> HUMAnN Databases ( database : build = location ) chocophlan : full = [http://huttenhower.sph.harvard.edu/humann\_data/chocophlan/full\_chocophlan.v201901\_v31.tar.gz](http://huttenhower.sph.harvard.edu/humann_data/chocophlan/full_chocophlan.v201901_v31.tar.gz) chocophlan : DEMO = [http://huttenhower.sph.harvard.edu/humann\_data/chocophlan/DEMO\_chocophlan.v201901\_v31.tar.gz](http://huttenhower.sph.harvard.edu/humann_data/chocophlan/DEMO_chocophlan.v201901_v31.tar.gz) uniref : uniref50\_diamond = [http://huttenhower.sph.harvard.edu/humann\_data/uniprot/uniref\_annotated/uniref50\_annotated\_v201901b\_full.tar.gz](http://huttenhower.sph.harvard.edu/humann_data/uniprot/uniref_annotated/uniref50_annotated_v201901b_full.tar.gz) uniref : uniref90\_diamond = [http://huttenhower.sph.harvard.edu/humann\_data/uniprot/uniref\_annotated/uniref90\_annotated\_v201901b\_full.tar.gz](http://huttenhower.sph.harvard.edu/humann_data/uniprot/uniref_annotated/uniref90_annotated_v201901b_full.tar.gz) uniref : uniref50\_ec\_filtered\_diamond = [http://huttenhower.sph.harvard.edu/humann\_data/uniprot/uniref\_ec\_filtered/uniref50\_ec\_filtered\_201901b\_subset.tar.gz](http://huttenhower.sph.harvard.edu/humann_data/uniprot/uniref_ec_filtered/uniref50_ec_filtered_201901b_subset.tar.gz) uniref : uniref90\_ec\_filtered\_diamond = [http://huttenhower.sph.harvard.edu/humann\_data/uniprot/uniref\_ec\_filtered/uniref90\_ec\_filtered\_201901b\_subset.tar.gz](http://huttenhower.sph.harvard.edu/humann_data/uniprot/uniref_ec_filtered/uniref90_ec_filtered_201901b_subset.tar.gz) uniref : DEMO\_diamond = [http://huttenhower.sph.harvard.edu/humann\_data/uniprot/uniref\_annotated/uniref90\_DEMO\_diamond\_v201901b.tar.gz](http://huttenhower.sph.harvard.edu/humann_data/uniprot/uniref_annotated/uniref90_DEMO_diamond_v201901b.tar.gz) utility\_mapping : full = [http://huttenhower.sph.harvard.edu/humann\_data/full\_mapping\_v201901b.tar.gz](http://huttenhower.sph.harvard.edu/humann_data/full_mapping_v201901b.tar.gz)

Based on what I can see at the URL where the tool downloads its databases from, [Index of /humann\_data/chocophlan](http://huttenhower.sph.harvard.edu/humann_data/chocophlan/), the version with the most recent date is actually `full_chocophlan.v201901_v31.tar.gz` and not `full_chocophlan.v296_201901b.tar.gz` (which is what I think the error message wants me to use?).What have I done wrong? Did I run with the wrong combination of databases?

Is `v296_201901b` actually the latest version, despite having a date listed at the download URL that is one year older than the `v201901_v31` database?

I see now in the [release announcement for HUMAnN 3.6](https://forum.biobakery.org/t/announcing-humann-3-6-critical-update/4155), it says::

> You DO NOT need to re-download the latest (v3.1) pangenome database

I’m interpreting this to mean that `http://huttenhower.sph.harvard.edu/humann_data/chocophlan/full_chocophlan.v201901_v31.tar.gz` is actually the latest ChocoPhlAn database to use, and not the 201901b variant the error message hinted at. Maybe updating that error message was overlooked in a recent release?

I am not sure how to proceed from here. I find version numbering of the HUMAnN database very confusing. Am I really supposed to be combining chocophlan database v201901\_v31 with uniref 201901b?

I am currently trying to redownload the latest databases (`full_chocophlan.v201901_v31.tar.gz` and `uniref90_annotated_v201901b_full.tar.gz`) from the URLs listed above to see if there is something wrong with my local copies.

---

<div class="post-metadata">

**Author:** ![franzosa](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/franzosa/32/3511_2.png) [@franzosa](https://forum.biobakery.org/u/franzosa)\
**Post date:** [June 23, 2023, 5:51pm UTC](https://forum.biobakery.org/t/humann3-v3-7-database-error-please-install-the-latest-version-of-the-database-201901b/5459/2 "2023-06-23T17:51:54Z")

</div>

Glad you managed to solve the problem! (See OP’s **bolded** comment at the top of the initial post for a solution.)
