Skip to content

Upgrade Puma to 8.x for Heroku Router 2.0 - #45

Merged
etagwerker merged 2 commits into
mainfrom
upgrade-puma-7
Nov 21, 2026
Merged

etagwerker merged 2 commits into
mainfrom
upgrade-puma-7

Conversation

@etagwerker

@etagwerker etagwerker commented Nov 21, 2026 •

Copy link
Copy Markdown
Member

Context

Heroku's build output now warns:

Heroku recommends using Puma 7.0.3+ for compatibility with Router 2.0

Changes

  • Bump puma from ~> 5.0 (5.6.5) to ~> 8.1 (8.1.2), the latest release
  • Lockfile only changes the puma entry

Notes

  • config/puma.rb only uses long-standing directives (threads, port,
    environment, pidfile, worker_timeout, plugin :tmp_restart), so no
    config changes were needed.
  • Puma 8.0.0 to 8.1.2 changelog reviewed. The only breaking change is that the
    default production bind address becomes :: (IPv6) when available. We bind
    explicitly via PORT, so this should not affect us.
  • 8.1.0 adds stricter request validation (for example, missing Host header or
    unescaped special characters in the path now get a 400). Worth watching logs
    for new 400s after deploy.
  • 8.x includes several security fixes (PROXY protocol, DoS/timeouts, TLS).

Testing

  • CI is green
  • App boots locally with bin/rails s
  • Deploy to staging/prod and confirm the Heroku warning is gone

🤖 Generated with Claude Code

Heroku recommends Puma 7.0.3+ for compatibility with Router 2.0.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@etagwerker
etagwerker temporarily deployed to librarian-production November 21, 2026 03:15 Inactive
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@etagwerker etagwerker changed the title Upgrade Puma to 7.x for Heroku Router 2.0 Upgrade Puma to 8.x for Heroku Router 2.0 Nov 21, 2026
@etagwerker
etagwerker temporarily deployed to librarian-production November 21, 2026 03:26 Inactive
@etagwerker
etagwerker merged commit 8e7d18f into main Nov 21, 2026
1 check passed

This branch was previously deployed

1 inactive deployment
librarian-production — 3e046e1d Deployed Nov 21, 2026 by etagwerker
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant