# Docker file and instructions for setting up ISIS on your Mac

**URL:** <https://openplanetary.discourse.group/t/docker-file-and-instructions-for-setting-up-isis-on-your-mac/614>\
**Category:** Tools and Web Services\
**Tags:** isis\
**Created:** [March 31, 2023, 9:57pm UTC](https://openplanetary.discourse.group/t/docker-file-and-instructions-for-setting-up-isis-on-your-mac/614 "2023-03-31T21:57:34Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![emmyrd](https://avatars.discourse-cdn.com/v4/letter/e/f05b48/32.png) [@emmyrd](https://openplanetary.discourse.group/u/emmyrd)\
**Post date:** [March 31, 2023, 9:57pm UTC](https://openplanetary.discourse.group/t/docker-file-and-instructions-for-setting-up-isis-on-your-mac/614/1 "2023-03-31T21:57:34Z")

</div>

Hi everyone, sharing a simple way I was able to set up ISIS on my mac.

I used a docker file (see below) that I got from a coworker who originally downloaded it from the NEOGeography StereoPipeline Toolkit public github page (although doesn’t look like the docker file still exists there).

You can install the docker file using:  
docker build - \< asp\_isis\_320.dockerfile -t asp\_isis\_320

Then, start up docker using the app on your computer, and run using:  
docker run -v $(pwd):/YourDataDir -it ContainerID

Now, you’ll be able to go back to your directory with examples using: cd /YourDataDir

Next, set the data and base paths to the data/kernels you downloaded from ISIS, for example:

export ISIS3DATA=“/YourDataDir/data” (or wherever your data is)  
export ISIS3BASE=“/YourDataDir/data/base”

And, now you can run ISIS commands such as (examples for LROC):  
lronac2isis from=M101013931RE.IMG to=M101013931RE.cub  
spiceinit web=true from=M10103931RE.cub  
campt from=M10103931RE.cub LINE=26112 SAMPLE=1266

Hope this is helpful! 🙂

## contents of asp\_isis\_320.dockerfile (since I couldn’t attach a .txt file)

# vim: ft=dockerfile:

FROM usgsastro/miniconda3

RUN conda update conda && \

# conda install python=3.6 && \

```
conda config --add channels conda-forge && \
conda config --add channels usgs-astrogeology

```

RUN conda install -c usgs-astrogeology isis=7.1.0  
RUN conda install -c conda-forge rclone

RUN apt-get update &&   
apt-get install libgl1 -y &&   
rm -rf /var/lib/apt/lists/\*

RUN bash -lc ‘python “$CONDA\_PREFIX/scripts/isisVarInit.py”’

RUN ln -s /opt/conda/testData /home/working

ENV asp\_version=3.2.0  
ENV stereo\_pipeline=StereoPipeline-3.2.0-2023-01-01-x86\_64-Linux

RUN wget [https://github.com/NeoGeographyToolkit/StereoPipeline/releases/download/${asp\_version}/${stereo\_pipeline}.tar.bz2](https://github.com/NeoGeographyToolkit/StereoPipeline/releases/download/$%7Basp_version%7D/$%7Bstereo_pipeline%7D.tar.bz2) -O /opt/${stereo\_pipeline}.tar.bz2  
#RUN wget [https://github.com/NeoGeographyToolkit/StereoPipeline/releases/${asp\_version}/${stereo\_pipeline}.tar.bz2](https://github.com/NeoGeographyToolkit/StereoPipeline/releases/$%7Basp_version%7D/$%7Bstereo_pipeline%7D.tar.bz2) -O /opt/${stereo\_pipeline}.tar.bz2  
RUN bzip2 -d /opt/${stereo\_pipeline}.tar.bz2  
RUN tar -xf /opt/${stereo\_pipeline}.tar -C /opt && rm /opt/${stereo\_pipeline}.tar  
ENV PATH “$PATH:/opt/${stereo\_pipeline}/bin”  
ENV ISISROOT “/opt/conda”  
ENV ISISDATA “/opt/conda/data”

RUN [“apt-get”, “–allow-releaseinfo-change”, “update”]  
RUN [“apt-get”, “-y”, “install”, “vim”]

WORKDIR “/home/working”

---

<div class="post-metadata">

**Author:** ![cmarmo](https://yyz2.discourse-cdn.com/free1/user_avatar/openplanetary.discourse.group/cmarmo/32/271_2.png) [@cmarmo](https://openplanetary.discourse.group/u/cmarmo)\
**Post date:** [April 1, 2023, 6:26am UTC](https://openplanetary.discourse.group/t/docker-file-and-instructions-for-setting-up-isis-on-your-mac/614/2 "2023-04-01T06:26:41Z")

</div>

Hi @emmyrd , welcome to the openplanetary forum!  
Thanks for sharing!

> [@emmyrd](#):
>
> Hope this is helpful! 🙂

You bet it is! 🌟

---

<div class="post-metadata">

**Author:** ![mariodamore](https://yyz2.discourse-cdn.com/free1/user_avatar/openplanetary.discourse.group/mariodamore/32/13_2.png) [@mariodamore](https://openplanetary.discourse.group/u/mariodamore)\
**Post date:** [April 11, 2023, 8:02am UTC](https://openplanetary.discourse.group/t/docker-file-and-instructions-for-setting-up-isis-on-your-mac/614/3 "2023-04-11T08:02:21Z")

</div>

@emmyrd thank you!

Do you know if this works with [podman?](https://podman.io/whatis.html) too?

PS: can you wrap your code in codeblocks for better readability? something like [Select the programming language used in code blocks - documentation / users - Discourse Meta](https://meta.discourse.org/t/select-the-programming-language-used-in-code-blocks/19247)

Best

---

<div class="post-metadata">

**Author:** ![emmyrd](https://avatars.discourse-cdn.com/v4/letter/e/f05b48/32.png) [@emmyrd](https://openplanetary.discourse.group/u/emmyrd)\
**Post date:** [April 11, 2023, 4:18pm UTC](https://openplanetary.discourse.group/t/docker-file-and-instructions-for-setting-up-isis-on-your-mac/614/4 "2023-04-11T16:18:57Z")

</div>

Same as above, just better formatting 🙂

```plaintext

vim: ft=dockerfile:
FROM usgsastro/miniconda3

RUN conda update conda && \

conda install python=3.6 && \
conda config --add channels conda-forge && \
conda config --add channels usgs-astrogeology
RUN conda install -c usgs-astrogeology isis=7.1.0
RUN conda install -c conda-forge rclone

RUN apt-get update &&
apt-get install libgl1 -y &&
rm -rf /var/lib/apt/lists/*

RUN bash -lc ‘python “$CONDA_PREFIX/scripts/isisVarInit.py”’

RUN ln -s /opt/conda/testData /home/working

ENV asp_version=3.2.0
ENV stereo_pipeline=StereoPipeline-3.2.0-2023-01-01-x86_64-Linux

RUN wget https://github.com/NeoGeographyToolkit/StereoPipeline/releases/download/${asp_version}/${stereo_pipeline}.tar.bz2 -O /opt/${stereo_pipeline}.tar.bz2
#RUN wget https://github.com/NeoGeographyToolkit/StereoPipeline/releases/${asp_version}/${stereo_pipeline}.tar.bz2 -O /opt/${stereo_pipeline}.tar.bz2
RUN bzip2 -d /opt/${stereo_pipeline}.tar.bz2
RUN tar -xf /opt/${stereo_pipeline}.tar -C /opt && rm /opt/${stereo_pipeline}.tar
ENV PATH “$PATH:/opt/${stereo_pipeline}/bin”
ENV ISISROOT “/opt/conda”
ENV ISISDATA “/opt/conda/data”

RUN [“apt-get”, “–allow-releaseinfo-change”, “update”]
RUN [“apt-get”, “-y”, “install”, “vim”]

WORKDIR “/home/working”

```

---

<div class="post-metadata">

**Author:** ![emmyrd](https://avatars.discourse-cdn.com/v4/letter/e/f05b48/32.png) [@emmyrd](https://openplanetary.discourse.group/u/emmyrd)\
**Post date:** [April 11, 2023, 4:20pm UTC](https://openplanetary.discourse.group/t/docker-file-and-instructions-for-setting-up-isis-on-your-mac/614/5 "2023-04-11T16:20:18Z")

</div>

Hi mariodamore, I’m not sure about podman, that’s my first time hearing about it!

---

<div class="post-metadata">

**Author:** ![mariodamore](https://yyz2.discourse-cdn.com/free1/user_avatar/openplanetary.discourse.group/mariodamore/32/13_2.png) [@mariodamore](https://openplanetary.discourse.group/u/mariodamore)\
**Post date:** [April 12, 2023, 12:42pm UTC](https://openplanetary.discourse.group/t/docker-file-and-instructions-for-setting-up-isis-on-your-mac/614/6 "2023-04-12T12:42:09Z")

</div>

@emmyrd no problem, I’ll test it at some point.

Thanks for the formatted code, I really appreciate the vim modeline on the top too 👍