> For the complete documentation index, see [llms.txt](https://docs.cosap.bio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cosap.bio/fundamentals/getting-set-up/cosap-via-docker.md).

# COSAP via Docker

We recommend using the containerized version of COSAP as it comes with all required packages installed.

## Installing Docker

If you do not have Docker Engine installed, you can follow the instructions at <https://docs.docker.com/engine/install/>

## Instructions

Pull the Docker image:&#x20;

```bash
docker pull itubioinformatics/cosap
```

You can run the COSAP Docker image with the docker run command:

```bash
docker run -it \
-v /<your_cosap_data_path>/:/cosap_data \
-v /<your_workdir>/:/workdir \
-v /var/run/docker.sock:/var/run/docker.sock \
itubioinformatics/cosap \
python <your_cosap_script.py>
```

#### Volumes

| Volume       | Description                                               |
| ------------ | --------------------------------------------------------- |
| /cosap\_data | Mount hg38 resources (COSAP\_LIBRARY\_PATH) to this path. |
| /workdir     | Your working directory.                                   |