Contributing

migetpacks is open source and available on GitHub. Contributions are welcome under the O’Saasy License.

Prerequisites

Docker (with BuildKit support)
Bash 4+
make (optional, for build shortcuts)

Project Structure

bin/
├── detect           # Language detection script
├── detect-version   # Version detection script
├── build            # Main build orchestrator
├── release          # Release metadata (Procfile parsing)
└── entrypoint.sh    # Container entrypoint (starts dockerd)

lib/
├── common.sh        # Shared helpers (output formatting, cache IDs)
├── buildpacks.sh    # Multi-buildpack support
├── nodejs.sh        # Node.js/npm/yarn/pnpm
├── python.sh        # Python/pip/uv
├── ruby.sh          # Ruby/Bundler/Rails
├── go.sh            # Go modules
├── rust.sh          # Rust/Cargo
├── java.sh          # Java/Maven/Gradle
├── kotlin.sh        # Kotlin/Gradle
├── scala.sh         # Scala/sbt
├── clojure.sh       # Clojure/Leiningen
├── dotnet.sh        # .NET/C#
├── php.sh           # PHP/Composer/FrankenPHP
├── elixir.sh        # Elixir/Phoenix
├── deno.sh          # Deno
└── bun.sh           # Bun

examples/            # Working example apps for each language
test/                # Test scripts

Development Commands

# Test the detect scripts
./test/test-detect.sh

# Detect language for an example app
./bin/detect examples/nodejs-example

# Detect version for an example app
LANGUAGE=nodejs ./bin/detect-version examples/nodejs-example

# Build the builder container
make build

# Push to registry
make push

Testing Locally

You can test builds locally without pushing to a remote registry:

# Build the migetpacks container
docker build -t migetpacks:local .

# Run a local build (image stays local, won't push)
docker run --rm \
  -v /path/to/your/app:/workspace/source \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e OUTPUT_IMAGE=my-app:local \
  migetpacks:local

# Test the built image
docker run --rm -p 5000:5000 my-app:local

When OUTPUT_IMAGE does not contain a registry prefix (e.g., my-app:local vs registry.io/my-app:latest), the builder uses the local Docker daemon and the image is not pushed.

Debugging Tips

Check the generated Dockerfile in the build output (Dockerfile.runtime)
Inspect the built image: docker run --rm my-app:local ls -la /app/
Check environment: docker run --rm my-app:local env

Example Apps

Working examples for all supported languages are in examples/:

Directory	Language
`nodejs-example`	Node.js
`deno-example`	Deno
`bun-example`	Bun
`python-example`	Python
`ruby-example`	Ruby
`go-hello-world`	Go
`rust-example`	Rust
`php-hello-world`	PHP
`java-hello-world`	Java
`kotlin-example`	Kotlin
`scala-example`	Scala
`dotnet-hello-world`	.NET
`elixir-example`	Elixir
`dockerfile-example`	Custom Dockerfile
`compose-example`	Docker Compose

Adding a New Language

To add support for a new language:

Add a detection function in bin/detect
Add a version detection function in bin/detect-version
Create a lib/{language}.sh with {language}_get_images(), {language}_generate_builder(), and {language}_generate_runtime() functions
Wire the new language into bin/build
Add an example app in examples/
Add tests in test/

Getting Started

Guides

Configuration

Languages

Deploying

Reference

Prerequisites

Project Structure

Development Commands

Testing Locally

Debugging Tips

Example Apps

Adding a New Language

​Prerequisites

​Project Structure

​Development Commands

​Testing Locally

​Debugging Tips

​Example Apps

​Adding a New Language

Prerequisites

Project Structure

Development Commands

Testing Locally

Debugging Tips

Example Apps

Adding a New Language