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

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 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.

Source: https://github.com/langfuse/langfuse/issues/4683