Procfile

Overview

migetpacks supports Procfiles for defining process types in your application. A Procfile declares the commands used to run different process types (web server, background workers, scheduled tasks, etc.).

Procfile Format

A Procfile is a plain text file named Procfile (no extension) in the project root. Each line declares a process type:

<process_type>: <command>

Example Procfile

web: bundle exec puma -C config/puma.rb
worker: bundle exec sidekiq
release: bundle exec rails db:migrate
clock: bundle exec clockwork clock.rb

Process Priority

migetpacks determines the main process command using the following priority order:

RUN_COMMAND environment variable

If set, this always takes precedence over any Procfile entry.

-e RUN_COMMAND="node server.js"

web: from Procfile

The web process type is the standard entry point for HTTP-serving applications.

First process in Procfile

If no web: entry exists, the first process declared in the Procfile is used.

Language-specific default

If no Procfile exists and RUN_COMMAND is not set, a language-specific default is used (e.g., node server.js, python app.py).

Language Examples

Ruby / Rails
Node.js
Python
Go
Java

web: bundle exec puma -C config/puma.rb
worker: bundle exec sidekiq
release: bundle exec rails db:migrate

web: node server.js
worker: node worker.js

web: gunicorn app:app --bind 0.0.0.0:5000
worker: celery -A tasks worker --loglevel=info

web: ./bin/app serve
worker: ./bin/app worker

web: java -jar target/app.jar
worker: java -jar target/worker.jar

Result JSON

Process information from the Procfile is recorded in the build result JSON (when RESULT_FILE is set):

{
  "status": "success",
  "processes": {
    "web": "bundle exec puma -C config/puma.rb",
    "release": "bundle exec rails db:migrate",
    "workers": [
      {"name": "sidekiq", "command": "bundle exec sidekiq"},
      {"name": "clock", "command": "bundle exec clockwork clock.rb"}
    ]
  }
}

Process Classification

Process Type	Classification	Description
`web`	Main process	HTTP-serving entry point
`release`	Release script	Run during deployment (e.g., migrations)
Any other	Worker	Background processes

Overriding with RUN_COMMAND

You can override the Procfile’s web process without modifying the file:

docker run --rm \
  -v /path/to/app:/workspace/source:ro \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e OUTPUT_IMAGE=registry.io/my-app:latest \
  -e RUN_COMMAND="bundle exec puma -p 5000 -w 4" \
  miget/migetpacks:latest

RUN_COMMAND only overrides the main container command (equivalent to Docker CMD). Worker processes from the Procfile are still recorded in the result JSON for deployment systems that support multiple process types.

DHI Considerations

When building with USE_DHI=true, Procfile commands are adjusted for distroless containers:

Shell-style commands are converted to exec format
Ruby shebang scripts (e.g., ./bin/rails) are prefixed with ruby (e.g., ruby bin/rails)
Shell variable expansions like ${PORT:-5000} are pre-expanded to literal values

Port Configuration

The PORT environment variable (default: 5000) is exposed in the container. Your Procfile command should bind to this port:

web: bundle exec puma -p $PORT

web: bundle exec puma -p 5000

# Set PORT=8080 when running migetpacks
web: node server.js --port $PORT

app.json Integration

If your project includes an app.json file, process formation (replicas) can be configured alongside the Procfile:

{
  "formation": {
    "web": {"quantity": 2, "size": "standard-1x"},
    "worker": {"quantity": 1}
  }
}

This formation data is included in the result JSON for deployment systems:

{
  "formation": [
    {"name": "web", "quantity": 2, "size": "standard-1x"},
    {"name": "worker", "quantity": 1, "size": null}
  ]
}

Getting Started

Guides

Configuration

Languages

Deploying

Reference

Overview

Procfile Format

Example Procfile

Process Priority

Language Examples

Result JSON

Process Classification

Overriding with RUN_COMMAND

DHI Considerations

Port Configuration

app.json Integration

​Overview

​Procfile Format

​Example Procfile

​Process Priority

​Language Examples

​Result JSON

​Process Classification

​Overriding with RUN_COMMAND

​DHI Considerations

​Port Configuration

​app.json Integration

Overview

Procfile Format

Example Procfile

Process Priority

Language Examples

Result JSON

Process Classification

Overriding with RUN_COMMAND

DHI Considerations

Port Configuration

app.json Integration