AWS-LC を静的リンクしたビルド済み Erlang/OTP をインストールします。GitHub Actions の composite action と、Ubuntu / macOS のインストーラーとして使えます。
- ビルド済みの tar.gz をダウンロードして展開するだけです
- dialyzer のベース PLT もダウンロードして
~/.cache/rebar3に配置します (無効にするには--no-pltまたはuse-plt: "false"を指定します) - 利用できるバージョンは versions/builds.tsv にあります
- uses: shiguredo/setup-erlang@main
with:
otp-version: "29.1.2"
aws-lc-version: "v5.12.0"otp-versionは完全一致で指定します (例:29.1.2)aws-lc-versionは省略できます。省略時はその Erlang/OTP で利用できる最新の AWS-LC を使いますdebugは文字列です。"true"のときだけデバッグ版を入れます。省略時とそれ以外の値は正式版です
デバッグ版を入れるときは debug を足します。
- uses: shiguredo/setup-erlang@main
with:
otp-version: "29.1.2"
aws-lc-version: "v5.12.0"
debug: "true"- デバッグ版のアセット名は
otp-<target>-debug.tar.gzです。GitHub Release のタグは正式版と同じotp-<otp-version>-aws-lc-<aws-lc-version>です - インストール先のディレクトリ名の末尾は
-debugです - dialyzer のベース PLT は正式版のものを使います。デバッグ版だけの PLT はありません
- Linux のデバッグ版は systemtap、macOS のデバッグ版は dtrace のプローブを含みます。
stapやdtraceコマンド自体は入れません
- uses: shiguredo/setup-erlang@main
with:
otp-version: "29.1.2"
aws-lc-version: "v5.12.0"
use-cache: "true"use-cacheを有効にするとインストールディレクトリを actions/cache でキャッシュします- self-hosted runner では actions/cache を使いません
RUNNER_TOOL_CACHE配下が runner に残るため、2 回目以降はインストール済みの Erlang/OTP をそのまま使います
use-pltはデフォルトで有効です。リリースに同梱された dialyzer のベース PLT (incremental) をダウンロードし、rebar3 が読む場所 (~/.cache/rebar3/rebar3_<OTP_VERSION>_iplt) に配置します- 無効にするには
use-plt: "false"を指定します - 対象のアプリは rebar3 のデフォルトと同じ
erts crypto kernel stdlibです - PLT のパスは
plt-path出力で参照できます - rebar3 のデフォルト設定 (
base_plt_location: global、base_plt_prefix: rebar3) が前提です
- 無効にするには
- dialyzer の incremental モードは、ベース PLT に記録された
warnings設定とプロジェクトのwarnings設定が完全一致しない場合、差分ではなく全ファイルを解析しますwarningsをカスタムしているプロジェクトでは、GitHub hosted runner で project PLT (_build/default/rebar3_*.iplt) を actions/cache で保存すると 2 回目以降が速くなります- self-hosted runner では
_buildが残るため追加のキャッシュは不要です
otp-version: インストールした Erlang/OTP のバージョンaws-lc-version: インストールした AWS-LC のバージョンerlang-root-dir: Erlang/OTP のインストールディレクトリplt-path: dialyzer のベース PLT のパス (use-pltが有効な場合のみファイルが存在します)debug: デバッグ版を入れたとき"true"
$ curl -fsSL https://raw.githubusercontent.com/shiguredo/setup-erlang/main/scripts/install.sh | bash- GitHub Actions 以外では
otp-versionを省略できます。省略時は対応する最新の Erlang/OTP と AWS-LC をインストールします - インストール先は
${XDG_DATA_HOME:-$HOME/.local/share}/setup-erlangです- 変更するには
--rootを指定するか、SETUP_ERLANG_ROOTを設定します
- 変更するには
- インストールすると
<root>/currentがインストールしたバージョンへのシンボリックリンクになります
# バージョンを指定してインストールする
$ curl -fsSL https://raw.githubusercontent.com/shiguredo/setup-erlang/main/scripts/install.sh | bash -s -- 29.1.2
# AWS-LC も指定してインストールする
$ curl -fsSL https://raw.githubusercontent.com/shiguredo/setup-erlang/main/scripts/install.sh | bash -s -- 29.1.2 v5.12.0
# デバッグ版をインストールする
$ curl -fsSL https://raw.githubusercontent.com/shiguredo/setup-erlang/main/scripts/install.sh | bash -s -- --debug 29.1.2 v5.12.0インストールの最後に表示される export PATH をシェルの設定ファイルに追加すると erl が使えるようになります。
$ export PATH="$HOME/.local/share/setup-erlang/current/bin:$PATH"
$ erl -noshell -eval 'io:format("~s~n", [erlang:system_info(otp_release)]), halt().'erlは$0の位置からルートディレクトリを探すため、bin/erl単位のシンボリックリンクでは動きません。currentのディレクトリ単位のシンボリックリンクを PATH に通してください
スクリプトを保存しておくと list と use が使えます。
$ curl -fsSL -o setup-erlang.sh https://raw.githubusercontent.com/shiguredo/setup-erlang/main/scripts/install.sh
$ bash setup-erlang.sh list
setup-erlang: installed under /Users/example/.local/share/setup-erlang
* 29.1.2-aws-lc-v5.12.0
setup-erlang: available for aarch64-apple-darwin
29.1.2 v5.11.0 v5.12.0
29.1.1 v5.9.0 v5.10.0 v5.11.0
29.1 v5.9.0
29.0.6 v5.8.0
$ bash setup-erlang.sh use 29.1.2 v5.12.0listはインストール済みのバージョン (先頭の*がcurrent) と、その環境で利用できるバージョンを表示しますuseはインストール済みのバージョンへcurrentを切り替えます
--otp-version/INPUT_OTP_VERSION: Erlang/OTP のバージョン (例:29.1.2)--aws-lc-version/INPUT_AWS_LC_VERSION: AWS-LC のバージョン (例:v5.12.0)--target/INPUT_OTP_TARGET: ターゲットトリプル。通常は自動検出します--root/SETUP_ERLANG_ROOT: インストール先--no-plt/INPUT_USE_PLT: dialyzer のベース PLT をインストールしません--debug/INPUT_DEBUG:"true"のときデバッグ版をインストールします。useとlistでも同じ指定でデバッグ版を選びますSETUP_ERLANG_MANIFEST: マニフェストファイルを直接指定しますSETUP_ERLANG_MANIFEST_URL: マニフェストの URL を指定します (既定はraw.githubusercontent.com/shiguredo/setup-erlang/main/versions/builds.tsv)SETUP_ERLANG_MANIFEST_REF: マニフェストを取得する ref を指定します (既定はmain)
- Ubuntu x86_64
- 26.04
- 24.04
- Ubuntu arm64
- 26.04
- 24.04
- macOS arm64
- 26
ビルド済みバイナリは glibc 2.38 以降が必要です。Ubuntu 22.04 以前では動作しません。macOS の x86_64 には対応していません。
正式版とデバッグ版は、同じ shiguredo/otp の aws-lc-OTP-* タグから作ります。アプリケーション構成は同じです。wx を使う observer、debugger、et はどちらにも入れません。
正式版の configure は docker-erlang-otp と同じです。
--enable-kernel-poll
--enable-dirty-schedulers
--enable-jit
--disable-sharing-preserving
--disable-sctp
--disable-dynamic-ssl-lib
--with-ssl=<AWS-LC のインストール先>
--with-ssl-rpath=no
--without-javac
--without-odbc
--without-wx
--without-debugger
--without-observer
--without-crashdump_viewer
--without-et
--without-tftp
--without-ftp
--without-megaco
--without-eldap
--without-diameter
--without-jinterface
--without-mnesia
--without-snmp
--without-erl_docgen
--without-ssh
デバッグ版は、このあとに次を足します。
--enable-lock-counter
--with-microstate-accounting=extra
--with-dynamic-trace=systemtap
--with-dynamic-trace=dtrace
--with-dynamic-trace=systemtapは Linux、--with-dynamic-trace=dtraceは macOS です--enable-lock-counterを付けると、make releaseが通常のbeam.smpに加えてbeam.lcnt.smpを入れます。起動はerl -emu_type lcntです- フレームポインタ付きの
beam.frmptr.smpは configure では選ばれないので、同じリリースツリーに対してmake -C erts/emulator TYPE=frmptr releaseで追加します。起動はerl -emu_type frmptrです - デバッグ版に入るエミュレータは、通常の
beam.smp、beam.lcnt.smp、beam.frmptr.smpです。通常のerlは最適化されたbeam.smpのままです。--with-microstate-accounting=extraと dynamic trace の計測点は、このbeam.smpに入ります - JIT 向けの
+JPperfはビルドオプションではありません。正式版でもデバッグ版でも、実行時に指定します
- AWS-LC を静的リンクした Erlang/OTP を提供しています
- shiguredo/otp の
aws-lc-OTP-*タグからビルドしています - 正式版のビルドオプションは docker-erlang-otp と同じです。デバッグ版の追加分は「ビルドオプション」にあります
- GitHub Actions と Ubuntu / macOS 向けのビルド済み Erlang/OTP
- Erlang/OTP のリリースに追従していく
Apache License 2.0
Copyright 2026 Shiguredo Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.