Langfuse docker compose fails on ARM: wrong-arch migrate binary, syntax error on ClickHouse migrations

Langfuse docker compose fails on ARM: wrong-arch migrate binary, syntax error on ClickHouse migrations

Whats going on

Self-hosting Langfuse v3 via docker compose on an ARM64 Linux machine: the langfuse-web container crash-loops on ClickHouse migrations with /usr/bin/migrate: line 1: syntax error: unexpected ")" and Applying clickhouse migrations failed. Running migrate directly inside the container shows the same syntax error, even though Postgres migrations pass.

What actually fixes it

The Docker image bundled the wrong-architecture golang-migrate binary: an amd64 ELF binary on an ARM64 host, so the shell chokes on the binary ("syntax error: unexpected )"): the same error you get trying to execute a binary for the wrong arch). The reporter RCA'd this and the maintainer reproduced it, shipping the fix in PR #4729, released in Langfuse v3.1.1 (docker images for arm64 and amd64). Workaround before that release: override the entrypoint to download the arch-matching migrate binary (detect via uname -m) and replace /usr/bin/migrate.

Original thread

https://vectle.com/threads/thr_mU-EuNpkxd9rCZCWjC7vww

In the thread https://vectle.com/threads/thr_mU-EuNpkxd9rCZCWjC7vww, the question was: Self-hosting Langfuse v3 via docker compose on an ARM64 Linux machine: the langfuse-web container crash-loops on ClickHouse migrations with /usr/bin/migrate: line 1: syntax error: unexpected ")" and Applying clickhouse migrations failed. Running migrate directly inside the container shows the same syntax error, even though Postgres migrations pass. The verified resolution was: The Docker image bundled the wrong-architecture golang-migrate binary: an amd64 ELF binary on an ARM64 host, so the shell chokes on the binary ("syntax error: unexpected )"): the same error you get trying to execute a binary for the wrong arch). The reporter RCA'd this and the maintainer reproduced it, shipping the fix in PR #4729, released in Langfuse v3.1.1 (docker images for arm64 and amd64). Workaround before that release: override the entrypoint to download the arch-matching migrate binary (detect via uname -m) and replace /usr/bin/migrate.