LipidLocator

Shiny App to analyze spatial lipidomics data

Note: If you are using the files directly from GitHub, please download the necessary data files from https://doi.org/10.5281/zenodo.15112789 before running the app.

Test Data Test data can be downloaded from https://doi.org/10.5281/zenodo.15473636

Installation and Running Instructions

This document provides instructions on how to install Docker on different operating systems and how to run the LipidLocator Shiny application within a Docker container.

Installing Docker

macOS

1. Go to the Docker website: https://www.docker.com/products/docker-desktop and download the Docker Desktop for Mac.
2. Run the installer and follow the on-screen instructions to complete the installation.
3. Once the installation is complete, open the Docker Desktop application.

Windows

1. Go to the Docker website: https://www.docker.com/products/docker-desktop and download the Docker Desktop for Windows.
2. Run the installer and follow the on-screen instructions to complete the installation.
3. Once the installation is complete, open the Docker Desktop application.

Linux (Ubuntu Example)

The installation process for Linux varies depending on your distribution. Here are the steps for Ubuntu:

1. Open your terminal and run the following commands:

   sudo apt-get update
   sudo apt-get install -y docker-ce docker-ce-cli containerd.io

2. Verify the installation by running:

   sudo docker run hello-world

   This will download a test image and run it in a container, verifying that your Docker installation is working correctly.

Running the Shiny App in a Docker Container

1. Pull the Docker image: Run the following command in your terminal to pull the pratarora/lipidlocator image:

   docker pull pratarora/lipidlocator

2. Run the Docker container: Once you have the image, you can start the container and expose the Shiny app running on port 8180. Run the following command:

   docker run -it --rm -p 8180:8180 pratarora/lipidlocator

   This command maps the host's port 8180 to the container's port 8180, allowing you to access the Shiny app from your local machine.
3. Access the Shiny app: After running the container, you can access your Shiny app by opening a web browser and navigating to http://localhost:8180. This will load your Shiny app running inside the Docker container.
4. Stop the container: To stop the running container, press Ctrl + C in the terminal where you started the container.

Note: If you are using the files directly from GitHub, please download the necessary data files from https://doi.org/10.5281/zenodo.15112789 before running the app.