# Humann3.0.0 docker not accepting metaphlan database 201901b

**URL:** <https://forum.biobakery.org/t/humann3-0-0-docker-not-accepting-metaphlan-database-201901b/2172>\
**Category:** Data resource\
**Created:** [May 28, 2021, 5:10pm UTC](https://forum.biobakery.org/t/humann3-0-0-docker-not-accepting-metaphlan-database-201901b/2172 "2021-05-28T17:10:18Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![Lewis-Gallagher](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/lewis-gallagher/32/827_2.png) [@Lewis-Gallagher](https://forum.biobakery.org/u/Lewis-Gallagher)\
**Post date:** [May 28, 2021, 5:10pm UTC](https://forum.biobakery.org/t/humann3-0-0-docker-not-accepting-metaphlan-database-201901b/2172/1 "2021-05-28T17:10:19Z")

</div>

Hi there,

I am using the Humann3.0.0 [docker image](https://hub.docker.com/layers/biobakery/humann/3.0.0/images/sha256-93bd689b011c34dd3ec95bfe418b51d0ea29c4e61dbaaa5aeaf5120ea8b2d3cd?context=explore) to run humann. I seem to be running into inconsistencies with databases.

I downloaded the full database with humman\_databases:

```auto
Singularity> humann_databases 
HUMANnN2 Databases ( database : build = location )
chocophlan : full = http://huttenhower.sph.harvard.edu/humann_data/chocophlan/full_chocophlan.v296_201901b.tar.gz
chocophlan : DEMO = http://huttenhower.sph.harvard.edu/humann_data/chocophlan/DEMO_chocophlan.v296_201901b.tar.gz
uniref : uniref50_diamond = 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
uniref : uniref50_ec_filtered_diamond = 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
uniref : DEMO_diamond = 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

```

I downloaded the chocophlan full, uiref90\_diamond and utility\_mapping full databases and began to run humann using the following command:

```auto
humann \
         --input ${fastq} \
         --output . \
         --threads ${params.cpus} \
         --output-basename ${baseName} \
         --verbose \
         --nucleotide-database ${params.nucleotideDb} \
         --protein-database ${params.proteinDb} \
         --bowtie-options="--threads ${params.cpus}" \
         --metaphlan-options="--bowtie2db ${params.nucleotideDb}"

```

I get the following error:

```auto
Downloading MetaPhlAn database
  Please note due to the size this might take a few minutes
  
  File /data/scratch/DCS/UDDU/CANBIO/lgallagher/ngs/4.resources/databases/microbiome//humann/humann_3.0.0//chocophlan/mpa_v30_CHOCOPhlAn_201901.tar already present!
  
  File /data/scratch/DCS/UDDU/CANBIO/lgallagher/ngs/4.resources/databases/microbiome//humann/humann_3.0.0//chocophlan/mpa_v30_CHOCOPhlAn_201901.md5 already present!
  MD5 checksums do not correspond! If this happens again, you should remove the database files and rerun MetaPhlAn so they are re-downloaded

```

No matter how many times I delete the database files and rerun the humann command.

I’ve read a few people on here recommend running `metaphlan --install $DBLOCATION` which I tried. Running the same humann command I get the following error:

```auto
CRITICAL ERROR: The directory provided for ChocoPhlAn contains files ( mpa_v30_CHOCOPhlAn_201901.1.bt2 ) that are not of the expected version. Please install the latest version of the database: 201901b.  

```

In the first step using `humann_databases --download` I downloaded the full\_chocophlan.v296\_201901b.tar.gz database, so I’m not sure why it thinks I don’t have that version.

Even when adding `--index mpa_v30_CHOCOPhlAn_201901` to the --metaphlan-options, I get a slightly different error, but is still asking me to download the version of the database I already have.

```auto
  CRITICAL ERROR: The directory provided for ChocoPhlAn contains files ( mpa_v30_CHOCOPhlAn_201901.tar ) that are not of the expected version. Please install the latest version of the database: 201901b

```

It was my understanding that `--index` is supposed to suppress the version checking function of metaphlan, so is this not working correctly?

The only way I’ve found to get humann working properly is to use the v3.0.0.a.4 Humann Docker container and install the v269\_201901 databases. As far as I’ve tried, with all the different combinations of database versions and humann versions, I cannot get humann 3.0.0 to work.

Perhaps this is a docker specific issue? As I haven’t seen anyone facing the same problem as me on the forum. Granted, I haven’t tried running it via conda, but my workflow is specifically designed with Docker in mind and would be troublesome to move to conda.

Any assistance would be great!

Thanks,

Lewis

P.S

Also while I’m here, when you run `humann_databases` why does the first line say `HUMANnN2 Databases ( database : build = location )` when ism running humann3? It’s a little misleading. Also there’s a typo in there, there aren’t 3 N’s in the name humann.

---

<div class="post-metadata">

**Author:** ![Dario](https://avatars.discourse-cdn.com/v4/letter/d/bc79bd/32.png) [@Dario](https://forum.biobakery.org/u/Dario)\
**Post date:** [May 30, 2021, 7:00am UTC](https://forum.biobakery.org/t/humann3-0-0-docker-not-accepting-metaphlan-database-201901b/2172/2 "2021-05-30T07:00:09Z")

</div>

> [@Lewis-Gallagher](#):
>
> It was my understanding that `--index` is supposed to suppress the version checking function of metaphlan, so is this not working correctly?

Same here. I installed simply by using `pip install` - nothing to do with containers. From the look of the file name, the database would be over two years old, a long time in genomics. I am also hoping for a 2021 update.

---

<div class="post-metadata">

**Author:** ![mpozuelor](https://avatars.discourse-cdn.com/v4/letter/m/b782af/32.png) [@mpozuelor](https://forum.biobakery.org/u/mpozuelor)\
**Post date:** [March 15, 2022, 2:16pm UTC](https://forum.biobakery.org/t/humann3-0-0-docker-not-accepting-metaphlan-database-201901b/2172/4 "2022-03-15T14:16:51Z")

</div>

I’m going crazy with this problem also, and I even have another problem, I am running in a cluster with singularity that has no internet in the nodes and cannot write in the image  
I’ve tried all the options that come to my mind but without any result.  
If I run metaphlan --install --index latest it downloads the map\_v30\_CHOCOPhlAn\_201901, giving this directory to --bowtie2db and --index map\_v30\_CHOCOPhlAn\_201901 in the options of metaphlan it gives the following error:

```auto
CRITICAL ERROR: The directory provided for ChocoPhlAn contains files ( mpa_v30_CHOCOPhlAn_201901.1.bt2 ) that are not of the expected version. Please install the latest version of the database: 201901b.  

```

If I download with humann\_databases the version 202901b, it tries to download the “latest” version for metaphlan, but breaks because it cannot write in singularity and there’s no internet connection.

Any new about this? We need to run this for a project and I’ve been nearly more than one month trying to install and Run HUMAnN3 in the cluster.

Thanks!
