From bf866b85c5a3a1bea77500d1302acb8bb1eb6d25 Mon Sep 17 00:00:00 2001 From: gbouras13 Date: Thu, 26 Sep 2024 21:53:07 +0930 Subject: [PATCH] add docs for container --- README.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/README.md b/README.md index 43bc5f4..aadfdfe 100644 --- a/README.md +++ b/README.md @@ -62,6 +62,7 @@ If you don't want to install `pharokka` or `phold` locally, you can run `pharokk - [Installation](#installation) - [Conda Installation](#conda-installation) - [Pip](#pip) + - [Container](#container) - [Source](#source) - [Database Installation](#database-installation) - [Beginner Conda Installation](#beginner-conda-installation) @@ -221,6 +222,29 @@ pip install pharokka You will still need to install the non-python dependencies manually. +## Container + +If you have Docker/Singularity/Apptainer installed, you can use the [biocontainers container](https://quay.io/repository/biocontainers/pharokka?tab=tags) (yes, every bioconda package has one!) + +You might find this useful if you have trouble with conda environments. + +For example to install `pharokka v1.7.3` with Singularity: + +``` +IMAGE_DIR="" +# e.g. to pull into the working directory +IMAGE_DIR=$PWD +singularity pull --dir $IMAGE_DIR docker://quay.io/biocontainers/pharokka:1.7.3--pyhdfd78af_0 +``` + +* Then to run, you use the same commands but prepended with `singularity exec <.sif file>` e.g.: + +``` +containerImage="$IMAGE_DIR/pharokka_1.7.3--pyhdfd78af_0.sif" +singularity exec $containerImage pharokka.py -h +``` + + ## Source Alternatively, the development version of `pharokka` (which may include new, untested features) can be installed manually via github.