lsbnb/mhcpan_shell repository overview

⁠🧬 NetMHCpan-4.2 Web Platform (lsbnb/mhcpan_shell)

A web-based interface and visualization platform for NetMHCpan-4.2.

⁠🚀 Quick Start Guide

⁠Option 1: Docker Desktop GUI (Windows / macOS — Recommended for GUI Users)

1. Pull Image: Open Docker Desktop, search for lsbnb/mhcpan_shell:latest in the top search bar, and click Pull.
2. Run Container: Go to Images, locate lsbnb/mhcpan_shell:latest, and click Run.
3. Configure Settings: Expand Optional Settings:
   • Host port: Enter 5001
   • Volumes (Optional — if you already extracted netMHCpan-4.2 on your computer):
     • Host path: Select your local netMHCpan-4.2 folder
     • Container path: Enter /opt/netMHCpan-4.2
4. Launch: Click Run, then open http://localhost:5001 in your web browser.

⁠Option 2: Command Line (Linux / macOS / Windows)

⁠1. Browser Setup Wizard (Easiest CLI)

If NetMHCpan-4.2 is not yet extracted on your host system:

docker run -d --name mhcpan-web -p 5001:5001 lsbnb/mhcpan_shell:latest

• Open http://localhost:5001 in your browser.
• Upload your official netMHCpan-4.2.Linux.tar.gz package (downloaded from DTU) on the /setup page, and the platform will configure itself automatically.

⁠2. Mount Extracted Directory

If you already extracted netMHCpan-4.2 locally:

• Linux / macOS Terminal:

  docker run -d \
    --name mhcpan-web \
    -p 5001:5001 \
    -v $(pwd)/netMHCpan-4.2:/opt/netMHCpan-4.2 \
    --restart unless-stopped \
    lsbnb/mhcpan_shell:latest
  

  Copy

• Windows PowerShell:

  docker run -d `
    --name mhcpan-web `
    -p 5001:5001 `
    -v ${PWD}/netMHCpan-4.2:/opt/netMHCpan-4.2 `
    --restart unless-stopped `
    lsbnb/mhcpan_shell:latest
  

  Copy

⁠3. Docker Compose

version: '3.8'

services:
  mhcpan-web:
    image: lsbnb/mhcpan_shell:latest
    container_name: mhcpan-web
    ports:
      - "5001:5001"
    volumes:
      - ./netMHCpan-4.2:/opt/netMHCpan-4.2
    restart: unless-stopped

Run docker compose up -d to start.

⁠🛠️ Management & Configuration

• View Logs: docker logs -f mhcpan-web
• Stop Container: docker stop mhcpan-web
• Restart Container: docker restart mhcpan-web