Changelog
Changelog
All notable changes to the RNA-seq Bioinformatics Toolkit Docker image will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[1.2.0] - 2026-11-15
R and all R/Bioconductor packages move to current versions (R 4.6.2). The image is 3.9 GB unpacked, down from 5.69 GB.
Changed
- CRAN packages: Installed as pre-built Linux binaries from Posit Public Package Manager instead of compiling from source; set site-wide so packages students install later are binaries too
- R installs: Packages install in parallel (
Ncpus), and the R steps run earlier in the Dockerfile so tool changes don’t redo them - Man pages: Restored by re-enabling man pages only, instead of
unminimize(which also restored ~1.3 GB of other docs); samtools man pages are now included - Java:
default-jdkreplaced by the smallerdefault-jre-headless - gnuplot: Replaced by
gnuplot-nox - Compilation: samtools, fastp and bedtools build with
make -j
Removed
- TopHat, Flexbar and bedops: Not used by the course lessons from this image
- Unused system packages:
ruby-full,xorg-dev,csh,cpanminus,libdbi-perl,libdbd-mysql-perl
Fixed
- sleuth install: Installed in its own step with
remotes, which current devtools no longer pulls in (the previous Dockerfile no longer built) - Build-time checks: The build fails if key R/Bioconductor packages or sleuth don’t load, instead of shipping without them
docker run <image> <tool> <args>now passes arguments through (previously thebash -centrypoint dropped them, e.g.samtools --helpran plainsamtools)build.shexits non-zero on failure, sorelease.shno longer tags/pushes a failed build
[1.1.1] - 2025-07-09
Added
- ggridges R package: Added to CRAN package installation for enhanced ridge line plotting capabilities
- Man pages support: Added man-db package and ran unminimize to restore documentation
- Educational Linux commands: Users can now use ‘man’ command to learn basic Linux commands within the container
Changed
- Column command package: Replaced util-linux with bsdextrautils for better column command functionality
- Docker group setup: Simplified by removing macOS-specific staff group configuration
- Course documentation: Updated various course posts with improved instructions for Docker approach
Fixed
- Column command functionality: Fixed missing bsdextrautils package for proper column command support
[1.1.0] - 2025-07-08
Added
- Apache Web Server: Configured to serve
/workspacedirectory on port 8080 - vim text editor: Added for command-line file editing
- bedtools 2.31.1: Genomic arithmetic operations tool
- Docker CLI tools: For running other bioinformatics containers
- less command: Added to runtime dependencies for better terminal experience
- util-linux package: Provides ‘column’ command and other utilities
- RNA-seq course environment variables: Comprehensive set added to bashrc
- Automatic Docker socket permission fixing: Cross-platform compatibility
- start-services.sh script: Streamlined container initialization
- Docker socket troubleshooting documentation: Comprehensive examples and guides
Changed
- BREAKING: Switched from Docker-in-Docker to host Docker engine approach for better stability
- Docker startup process: Improved with ENTRYPOINT + CMD pattern for proper signal handling
- Apache configuration: Enhanced with ServerName directive and workspace symlink
- README organization: Streamlined by merging redundant sections
- Docker run examples: Updated to include port mapping (-p 8080:8080)
- FastQC installation: Fixed to include complete directory structure and JAR files
- PATH environment: Updated to include FastQC directory for proper execution
Fixed
- Interactive session stability: Eliminated glitchy sessions caused by Docker-in-Docker setup
- Docker socket permissions: Automatic fixing on macOS and Linux systems
- Apache configuration: Fixed workspace directory permissions
- Container startup reliability: Improved performance and stability
- FastQC execution: Fixed installation to ensure proper tool functionality
[1.0.1] - 2025-07-06
Added
- Added ncurses development libraries (libncurses5-dev, libncursesw5-dev) to runtime dependencies
- Fixed missing “&&” operator in runtime apt-get install command
Changed
- Enhanced container usability by allowing users to compile ncurses-dependent tools like samtools inside the running container
[1.0.0] - 2025-07-04
Added
- Initial release of the RNA-seq Bioinformatics Toolkit
- Ubuntu 22.04 LTS base image with x86_64 architecture
- Multi-stage build optimization for reduced image size
- Comprehensive bioinformatics tools suite including:
- SAMtools, bam-readcount, HISAT2, StringTie, gffcompare
- htseq-count, TopHat, kallisto, FastQC, MultiQC
- Picard, Flexbar, Regtools, RSeQC, bedops
- gtfToGenePred, genePredToBed, how_are_we_stranded_here
- Python 3 environment with scientific computing packages
- R 4.x with essential bioinformatics libraries
- Bioconductor packages for RNA-seq analysis
Technical Improvements
- Platform-specific builds for Apple Silicon compatibility
- SSL certificate handling for problematic downloads
- Controlled numpy version for HTSeq compatibility
- Strategic Python package installation order
- Essential build tools for R package compilation
- Robust error handling and fallback mechanisms
Fixed
- ARM/x86 architecture conflicts on Apple Silicon Macs
- SSL certificate verification issues
- Package version compatibility problems
- Multi-stage build optimization
- Parallel compilation control to prevent build failures
Infrastructure
- Automated build script with platform detection
- Comprehensive documentation and usage examples
- Development notes for troubleshooting