Build & Push Docker Images (Mac M2/M3/M4) + Singularity

1. Build Docker Image on Mac (Apple Silicon)

Make sure your Dockerfile is in the current directory.

docker buildx build --platform linux/amd64 -t <username>/<software>:<version> .

Example:

docker buildx build --platform linux/amd64 -t sjiang/bwa:0.7.17 .

---

2. Push Image to Docker Hub

Login:

docker login

Push:

docker push <username>/<software>:<version>

---

3. Pull Image & Run Container Locally

Pull:

docker pull <username>/<software>:<version>

Run interactively:

docker run -it --name <container_name> <username>/<software>:<version> /bin/bash

Example:

docker run -it --name bwa_test sjiang/bwa:0.7.17 /bin/bash

---

4. Create Singularity .sif Image (on HPC)

Pull directly from Docker Hub:

singularity pull <software>-<version>.sif docker://<username>/<software>:<version>

Example:

singularity pull bwa-0.7.17.sif docker://sjiang/bwa:0.7.17

---