gleam-lang/gleam

Have Erlang shipments print a warning if being run with a different OTP major version

Open

#4,769 opened on Jul 10, 2025

View on GitHub
 (1 comment) (2 reactions) (0 assignees)Rust (960 forks)batch import
discussionhelp wanted

Repository metrics

Stars
 (21,417 stars)
PR merge metrics
 (Avg merge 10d 19h) (69 merged PRs in 30d)

Description

Update: It looks like the error was caused because the newer docker images use Erlang 28 and I was trying to run the exported shipment with Erlang 27. Maybe a check could be added to the entrypoint script to make sure you're running it with the correct Erlang version since the current error message is pretty cryptic.

When I run gleam export erlang-shipment on a fresh project in the v1.11.1-erlang docker image and then try to do ./entrypoint.sh run, the app crashes with the following error:

Error! Failed to eval: docker_gleam_test@@main:run(docker_gleam_test)

Runtime terminating during boot ({undef,[{'docker_gleam_test@@main',run,[docker_gleam_test],[]},{erl_eval,do_apply,7,[{file,"erl_eval.erl"},{line,915}]},{init,start_it,1,[]},{init,start_em,1,[]},{init,do_boot,3,[]}]})

Crash dump is being written to: erl_crash.dump...done

The same issue occurs with v1.11.0-erlang but not with v1.10.0-erlang.

Contributor guide

Research direction
Inspect the entrypoint.sh script in the Erlang shipment export. Add a check that compares the OTP major version used to build the shipment with the OTP major version in the runtime environment, and print a warning if they differ.
Tech stack
shelldocker
Domain
backenddevops
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
1
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
ShellDocker
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75