Can someone share the aarch64/arm64 Docker file?

[smartnikocj]

Could someone share the aarch64/arm64 Docker file? What's the version, and how do I configure the docker-compose file? I've tried many times but haven't succeeded.

#341

[amhsirak]

@smartnikocj Arm64 images are available on Docker Hub & are functional. Can you share more about the issue you're facing? Any error messages/logs?

[smartnikocj]

I have an arm64 system and am facing an error possibly due to this. Should I use arm64-specific images, and how do I configure Compose and the environment? Thanks. @amhsirak

Below are my compose, environment, and the issue I'm facing.

compose：
version: '3.8'

services:
  postgres:
    image: postgres:13
    environment:
      POSTGRES_USER: ${DB_USER}
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_DB: ${DB_NAME}
    ports:
      - "5432:5432" 
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 10s
      timeout: 5s
      retries: 5

  redis:
    image: redis:6
    ports:
      - "6379:6379" 
    volumes:
      - redis_data:/data

  minio:
    image: minio/minio
    environment:
      MINIO_ROOT_USER: ${MINIO_ACCESS_KEY}
      MINIO_ROOT_PASSWORD: ${MINIO_SECRET_KEY}
    command: server /data --console-address ":${MINIO_CONSOLE_PORT}"
    ports:
      - "9000:9000"   
      - "9001:9001"   
    volumes:
      - minio_data:/data

  backend:
    image: getmaxun/maxun-backend:latest
    ports:
      - "8082:8080" 
    env_file: .env
    environment:
      PLAYWRIGHT_BROWSERS_PATH: /ms-playwright
      CHROMIUM_FLAGS: '--disable-gpu --no-sandbox --headless=new'
    security_opt:
      - seccomp=unconfined
    shm_size: '2gb'
    mem_limit: 2g
    
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_started
      minio:
        condition: service_started
        
  frontend:
    image: getmaxun/maxun-frontend:latest
    ports:
      - "5173:5173" 
    env_file: .env
    depends_on:
      - backend

volumes:
  postgres_data:
  minio_data:
  redis_data:

env：
NODE_ENV=production
JWT_SECRET="7vT\$pL2qZ9sXk!fHjKm3cD6B"

# PostgreSQL 配置
DB_NAME=maxun
DB_USER=postgres
DB_PASSWORD=postgres
DB_HOST=postgres
DB_PORT=5432

# 加密密钥
ENCRYPTION_KEY=9a8b7c6d5f7a6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8

# MinIO 配置
MINIO_ENDPOINT=minio
MINIO_PORT=9000
MINIO_CONSOLE_PORT=9001
MINIO_ACCESS_KEY="mXkPq2"
MINIO_SECRET_KEY="dF5gH#jKl8mN9oPwX4yZ5"

# Redis 配置
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD="R3dure2023"

# 端口和 URL 配置
BACKEND_PORT=8082
BACKEND_URL=http://localhost:8082
PUBLIC_URL=http://localhost:5173
VITE_BACKEND_URL=http://localhost:8082
VITE_PUBLIC_URL=http://localhost:5173

# 遥测配置
MAXUN_TELEMETRY=true

# 可选 OAuth 配置
#GOOGLE_CLIENT_ID=your_google_client_id
#GOOGLE_CLIENT_SECRET=your_google_client_secret
#GOOGLE_REDIRECT_URI=your_google_redirect_uri
#AIRTABLE_CLIENT_ID=your_airtable_client_id
#AIRTABLE_REDIRECT_URI=http://localhost:8082/auth/airtable/callback

错误：
[root@22-11-27-0200 maxun]# docker-compose logs
maxun-backend-1  | exec /usr/bin/npm: exec format error
maxun-minio-1    | INFO: Formatting 1st pool, 1 set(s), 1 drives per set.
maxun-minio-1    | INFO: WARNING: Host local has more than 0 drives of set. A host failure will result in data becoming unavailable.
maxun-minio-1    | MinIO Object Storage Server
maxun-minio-1    | Copyright: 2015-2025 MinIO, Inc.
maxun-minio-1    | License: GNU AGPLv3 - https://www.gnu.org/licenses/agpl-3.0.html
maxun-minio-1    | Version: RELEASE.2025-04-08T15-41-24Z (go1.24.2 linux/arm64)
maxun-minio-1    | 
maxun-minio-1    | API: http://xxx:9000  http://127.0.0.1:9000 
maxun-minio-1    | WebUI: http://xxx:9001 http://127.0.0.1:9001 
maxun-minio-1    | 
maxun-minio-1     | Docs: https://docs.min.io
maxun-frontend-1  | exec /usr/local/bin/docker-entrypoint.sh: exec format error
maxun-redis-1     | 1:C 09 Apr 2025 02:38:22.025 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo
maxun-redis-1     | 1:C 09 Apr 2025 02:38:22.025 # Redis version=6.2.17, bits=64, commit=00000000, modified=0, pid=1, just started
maxun-redis-1     | 1:C 09 Apr 2025 02:38:22.025 # Warning: no config file specified, using the default config. In order to specify a config file use redis-server /path/to/redis.conf
maxun-redis-1     | 1:M 09 Apr 2025 02:38:22.025 * monotonic clock: POSIX clock_gettime
maxun-redis-1     | 1:M 09 Apr 2025 02:38:22.026 * Running mode=standalone, port=6379.
maxun-redis-1     | 1:M 09 Apr 2025 02:38:22.026 # WARNING: The TCP backlog setting of 511 cannot be enforced because /proc/sys/net/core/somaxconn is set to the lower value of 128.
maxun-redis-1     | 1:M 09 Apr 2025 02:38:22.026 # Server initialized
maxun-redis-1     | 1:M 09 Apr 2025 02:38:22.026 # WARNING Memory overcommit must be enabled! Without it, a background save or replication may fail under low memory condition. Being disabled, it can can also cause failures without low memory condition, see https://github.com/jemalloc/jemalloc/issues/1328. To fix this issue add 'vm.overcommit_memory = 1' to /etc/sysctl.conf and then reboot or run the command 'sysctl vm.overcommit_memory=1' for this to take effect.
maxun-redis-1     | 1:M 09 Apr 2025 02:38:22.027 * Ready to accept connections
maxun-postgres-1  | The files belonging to this database system will be owned by user "postgres".
maxun-postgres-1  | This user must also own the server process.
maxun-postgres-1  | 
maxun-postgres-1  | The database cluster will be initialized with locale "en_US.utf8".
maxun-postgres-1  | The default database encoding has accordingly been set to "UTF8".
maxun-postgres-1  | The default text search configuration will be set to "english".
maxun-postgres-1  | 
maxun-postgres-1  | Data page checksums are disabled.
maxun-postgres-1  | 
maxun-postgres-1  | fixing permissions on existing directory /var/lib/postgresql/data ... ok
maxun-postgres-1  | creating subdirectories ... ok
maxun-postgres-1  | selecting dynamic shared memory implementation ... posix
maxun-postgres-1  | selecting default max_connections ... 100
maxun-postgres-1  | selecting default shared_buffers ... 128MB
maxun-postgres-1  | selecting default time zone ... Etc/UTC
maxun-postgres-1  | creating configuration files ... ok
maxun-postgres-1  | running bootstrap script ... ok
maxun-postgres-1  | performing post-bootstrap initialization ... ok
maxun-postgres-1  | syncing data to disk ... ok
maxun-postgres-1  | 
maxun-postgres-1  | 
maxun-postgres-1  | Success. You can now start the database server using:
maxun-postgres-1  | 
maxun-postgres-1  |     pg_ctl -D /var/lib/postgresql/data -l logfile start
maxun-postgres-1  | 
maxun-postgres-1  | initdb: warning: enabling "trust" authentication for local connections
maxun-postgres-1  | You can change this by editing pg_hba.conf or using the option -A, or
maxun-postgres-1  | --auth-local and --auth-host, the next time you run initdb.
maxun-postgres-1  | waiting for server to start....2025-04-09 02:38:23.060 UTC [48] LOG:  starting PostgreSQL 13.20 (Debian 13.20-1.pgdg120+1) on aarch64-unknown-linux-gnu, compiled by gcc (Debian 12.2.0-14) 12.2.0, 64-bit
maxun-postgres-1  | 2025-04-09 02:38:23.062 UTC [48] LOG:  listening on Unix socket "/var/run/postgresql/.s.PGSQL.5432"
maxun-postgres-1  | 2025-04-09 02:38:23.066 UTC [49] LOG:  database system was shut down at 2025-04-09 02:38:22 UTC
maxun-postgres-1  | 2025-04-09 02:38:23.069 UTC [48] LOG:  database system is ready to accept connections
maxun-postgres-1  |  done
maxun-postgres-1  | server started
maxun-postgres-1  | CREATE DATABASE
maxun-postgres-1  | 
maxun-postgres-1  | 
maxun-postgres-1  | /usr/local/bin/docker-entrypoint.sh: ignoring /docker-entrypoint-initdb.d/*
maxun-postgres-1  | 
maxun-postgres-1  | waiting for server to shut down...2025-04-09 02:38:23.264 UTC [48] LOG:  received fast shutdown request
maxun-postgres-1  | .2025-04-09 02:38:23.265 UTC [48] LOG:  aborting any active transactions
maxun-postgres-1  | 2025-04-09 02:38:23.267 UTC [48] LOG:  background worker "logical replication launcher" (PID 55) exited with exit code 1
maxun-postgres-1  | 2025-04-09 02:38:23.268 UTC [50] LOG:  shutting down
maxun-postgres-1  | 2025-04-09 02:38:23.285 UTC [48] LOG:  database system is shut down
maxun-postgres-1  |  done
maxun-postgres-1  | server stopped
maxun-postgres-1  | 
maxun-postgres-1  | PostgreSQL init process complete; ready for start up.
maxun-postgres-1  | 
maxun-postgres-1  | 2025-04-09 02:38:23.380 UTC [1] LOG:  starting PostgreSQL 13.20 (Debian 13.20-1.pgdg120+1) on aarch64-unknown-linux-gnu, compiled by gcc (Debian 12.2.0-14) 12.2.0, 64-bit
maxun-postgres-1  | 2025-04-09 02:38:23.381 UTC [1] LOG:  listening on IPv4 address "0.0.0.0", port 5432
maxun-postgres-1  | 2025-04-09 02:38:23.381 UTC [1] LOG:  listening on IPv6 address "::", port 5432
maxun-postgres-1  | 2025-04-09 02:38:23.383 UTC [1] LOG:  listening on Unix socket "/var/run/postgresql/.s.PGSQL.5432"
maxun-postgres-1  | 2025-04-09 02:38:23.387 UTC [63] LOG:  database system was shut down at 2025-04-09 02:38:23 UTC
maxun-postgres-1  | 2025-04-09 02:38:23.391 UTC [1] LOG:  database system is ready to accept connections
[root@22-11-27-0200 maxun]# docker-compose logs backend
maxun-backend-1  | exec /usr/bin/npm: exec format error
[root@22-11-27-0200 maxun]# docker-compose ps
NAME                COMMAND                  SERVICE             STATUS              PORTS
maxun-backend-1     "npm run server"         backend             exited (1)          
maxun-frontend-1    "docker-entrypoint.s…"   frontend            exited (1)          
maxun-minio-1       "/usr/bin/docker-ent…"   minio               running             0.0.0.0:9000-9001->9000-9001/tcp, :::9000-9001->9000-9001/tcp
maxun-postgres-1    "docker-entrypoint.s…"   postgres            running (healthy)   0.0.0.0:5432->5432/tcp, :::5432->5432/tcp
maxun-redis-1       "docker-entrypoint.s…"   redis               running             0.0.0.0:6379->6379/tcp, :::6379->6379/tcp
[root@22-11-27-0200 maxun]# curl http://localhost:8082/healthcheck
curl: (7) Failed to connect to localhost port 8082: 拒绝连接
[root@22-11-27-0200 maxun]# curl -I http://localhost:5173
curl: (7) Failed to connect to localhost port 5173: 拒绝连接

[bajins]

The error exec /usr/local/bin/docker-entrypoint.sh: exec format error typically occurs due to incorrect line endings in the docker-entrypoint.sh script. This script likely uses CRLF (Windows-style line endings) instead of LF (Unix-style line endings), causing the Linux-based Docker container to fail execution.

[AlexCxx]

Same issue here, tried on Raspberry 4, here is my config:

Distributor ID: Debian
Description:    Debian GNU/Linux 12 (bookworm)
Release:        12
Codename:       bookworm

Docker Compose up traces:

postgres-1  | 
postgres-1  | PostgreSQL Database directory appears to contain a database; Skipping initialization
postgres-1  | 
postgres-1  | 2025-05-04 21:14:39.817 UTC [1] LOG:  starting PostgreSQL 13.20 (Debian 13.20-1.pgdg120+1) on aarch64-unknown-linux-gnu, compiled by gcc (Debian 12.2.0-14) 12.2.0, 64-bit
postgres-1  | 2025-05-04 21:14:39.818 UTC [1] LOG:  listening on IPv4 address "0.0.0.0", port 5432
postgres-1  | 2025-05-04 21:14:39.818 UTC [1] LOG:  listening on IPv6 address "::", port 5432
postgres-1  | 2025-05-04 21:14:39.847 UTC [1] LOG:  listening on Unix socket "/var/run/postgresql/.s.PGSQL.5432"
postgres-1  | 2025-05-04 21:14:39.869 UTC [27] LOG:  database system was shut down at 2025-05-04 21:03:28 UTC
postgres-1  | 2025-05-04 21:14:39.900 UTC [1] LOG:  database system is ready to accept connections
backend-1   | exec /usr/bin/npm: exec format error
backend-1 exited with code 255
minio-1     | MinIO Object Storage Server
minio-1     | Copyright: 2015-2025 MinIO, Inc.
minio-1     | License: GNU AGPLv3 - https://www.gnu.org/licenses/agpl-3.0.html
minio-1     | Version: RELEASE.2025-04-22T22-12-26Z (go1.24.2 linux/arm64)
minio-1     | 
minio-1     | API: http://172.18.0.2:9000  http://127.0.0.1:9000 
minio-1     | WebUI: http://172.18.0.2:9001 http://127.0.0.1:9001  
minio-1     | 
minio-1     | Docs: https://docs.min.io
frontend-1  | exec /usr/local/bin/docker-entrypoint.sh: exec format error
frontend-1 exited with code 255
Gracefully stopping... (press Ctrl+C aga

Also tried with previous versions of Front & Back end (0.11.0), got the same error

[scott-mackenzie]

After getting the image to run in debug session the below file doesn't seem correct.

Please confirm.

Within the arm64 container the file:

===================== docker-entrypoint.sh ======

/usr/local/bin/docker-entrypoint.sh

#!/usr/bin/env bash
set -Eeuo pipefail

"# first arg is -f or --some-option"
"# or there are no args"
if [ "$#" -eq 0 ] || [ "${1#-}" != "$1" ]; then
# docker run bash -c 'echo hi'
exec bash "$@"
fi

exec "$@"

=============== End of File ============

Same error. Images are confirmed arm64

root@maxun:~/maxun# docker-compose logs backend
Attaching to maxun_backend_1
backend_1 | exec /usr/bin/npm: exec format error
backend_1 | exec /usr/bin/npm: exec format error
backend_1 | exec /usr/bin/npm: exec format error
backend_1 | exec /usr/bin/npm: exec format error
backend_1 | exec /usr/bin/npm: exec format error
backend_1 | exec /usr/bin/npm: exec format error

root@maxun:~/maxun# docker-compose logs frontend
Attaching to maxun_frontend_1
frontend_1 | exec /usr/local/bin/docker-entrypoint.sh: exec format error
frontend_1 | exec /usr/local/bin/docker-entrypoint.sh: exec format error
frontend_1 | exec /usr/local/bin/docker-entrypoint.sh: exec format error
frontend_1 | exec /usr/local/bin/docker-entrypoint.sh: exec format error
frontend_1 | exec /usr/local/bin/docker-entrypoint.sh: exec format error
frontend_1 | exec /usr/local/bin/docker-entrypoint.sh: exec format error

root@maxun:~/maxun# docker image inspect getmaxun/maxun-frontend |grep Architecture
"Architecture": "arm64",

root@maxun:~/maxun# docker image inspect getmaxun/maxun-backend |grep Architecture
"Architecture": "arm64",

root@maxun:~/maxun# dpkg --print-architecture
arm64

root@maxun:~/maxun# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
5e9d0694305e minio/minio "/usr/bin/docker-ent…" About an hour ago Up About an hour 0.0.0.0:9000-9001->9000-9001/tcp, [::]:9000-9001->9000-9001/tcp maxun_minio_1
0e6633350aee postgres:13 "docker-entrypoint.s…" About an hour ago Up About an hour (healthy) 0.0.0.0:5432->5432/tcp, [::]:5432->5432/tcp maxun_postgres_1

The minio and postgres start up without issue. Only issue is the frontend and backend do not start.

STEPS TO REPLICATE:

1. Build new ubuntu 24.04 vm
2. update and upgrade
3. install docker and docker-compose
4. sudo su (root)
5. cd ~
6. git clone https://github.com/getmaxun/maxun.git
7. cd maxun
8. docker-compose up -d

RESULT
root@maxun:~/maxun# docker-compose up -d
maxun_postgres_1 is up-to-date
maxun_minio_1 is up-to-date
Starting maxun_backend_1 ... done
Starting maxun_frontend_1 ... done

EXPECTED RESULT
working.

ACTUAL RESULT
see above errors.

*Can't get past the error. Not amd64 versus arm64 issue as architecture checked and confirmed.

Docker Inspect image:

root@maxun:~/maxun# docker inspect getmaxun/maxun-frontend
[
{
"Id": "sha256:0b9627f5b073697b3c37c03180af85be9422421c92a34ebd5cba62c57c64bb63",
"RepoTags": [
"getmaxun/maxun-frontend:latest"
],
"RepoDigests": [
"getmaxun/maxun-frontend@sha256:339469a9c2d32d1cfc120f699e0a5162bb5a2f68a7c2262cd7e59d20c12c4a3b"
],
"Parent": "",
"Comment": "buildkit.dockerfile.v0",
"Created": "2025-05-08T11:54:42.923586789Z",
"DockerVersion": "",
"Author": "",
"Config": {
"Hostname": "",
"Domainname": "",
"User": "",
"AttachStdin": false,
"AttachStdout": false,
"AttachStderr": false,
"ExposedPorts": {
"5173/tcp": {}
},
"Tty": false,
"OpenStdin": false,
"StdinOnce": false,
"Env": [
"PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
"NODE_VERSION=18.20.8",
"YARN_VERSION=1.22.22"
],
"Cmd": [
"npm",
"run",
"client",
"--",
"--host"
],
"ArgsEscaped": true,
"Image": "",
"Volumes": null,
"WorkingDir": "/app",
"Entrypoint": [
"docker-entrypoint.sh"
],
"OnBuild": null,
"Labels": null
},
"Architecture": "arm64",
"Os": "linux",
"Size": 691534964,
"GraphDriver": {
"Data": {
"LowerDir": "/var/lib/docker/overlay2/b97239152478983902fc6fa281ef3d1b7c0387d72b67fac8a2d6f2148cd0c65d/diff:/var/lib/docker/overlay2/ca4ce799b76685db5550785f4dc1dd60ed28bae0b1c3a01500c49fbeb504ea50/diff:/var/lib/docker/overlay2/8c70dc8b330215a441169cfcadddfbaeb8ae543270c3c1b8d57d340404f7766b/diff:/var/lib/docker/overlay2/ec6566033c615c6cd3f549209fd7367ddbe561d0236f5736e5390f95ae12ba3b/diff:/var/lib/docker/overlay2/3394488c03edea8c84b73724addf5244167d180a05f446345517016627ffdce8/diff:/var/lib/docker/overlay2/683aef901434dc5aff17948664a147b221a3fe36b3b79ee182e1d41387b571d8/diff:/var/lib/docker/overlay2/909a5cc40b9a5ccb7d81d16846e9fde841d132f0928058a0ce4870b934f71ca7/diff:/var/lib/docker/overlay2/285dc3438f69ade56668fb7a1c9a3fc9f50e5b965f041be414cd9b560d0cfa2f/diff:/var/lib/docker/overlay2/3c737e1714c6eae5c7193aab0d0d30f674b703393fa087b11238a41d563faf40/diff:/var/lib/docker/overlay2/e00d97d956115fbef1c5cf2135e13fac45d088d3b6819b411e3f054b722478f8/diff:/var/lib/docker/overlay2/c1491e519c43de3fdc0dc681d7e5d9f8379f854841939858a04d28b9f2a3e51b/diff",
"MergedDir": "/var/lib/docker/overlay2/bcd224c3431d7e51f9a0a8ed96708574df5afd5c1d5020b57f1b8bd467e6208b/merged",
"UpperDir": "/var/lib/docker/overlay2/bcd224c3431d7e51f9a0a8ed96708574df5afd5c1d5020b57f1b8bd467e6208b/diff",
"WorkDir": "/var/lib/docker/overlay2/bcd224c3431d7e51f9a0a8ed96708574df5afd5c1d5020b57f1b8bd467e6208b/work"
},
"Name": "overlay2"
},
"RootFS": {
"Type": "layers",
"Layers": [
"sha256:08000c18d16dadf9553d747a58cf44023423a9ab010aab96cf263d2216b8b350",
"sha256:0b1f26057bd0491a50f56fd7f2983bd3ad478511f12fff2b361a97c50cb5828b",
"sha256:f3b40b0cdb1caad1db11b8589c814f85b3e69f3ed33f64a686e465e74a47c9f0",
"sha256:82140d9a70a706b719632fec8e4d083419fc62159f94afec80dcabc52e0ed0d2",
"sha256:a763b7c5dc78e4e76b7fd4cde9eb9a2e419568b4b942bf4b39df7ca52fd1e38a",
"sha256:4131a7fc2f928af41dbf753cfa9f3947beeb9b67051170e9f0be9bf90a2a339e",
"sha256:999ba8c56006f57d7e13c36b2cda015341041f8fc186e400ffeb822cfc77e0f2",
"sha256:3c4ef1dfc2a45100c391c7db13270239507ba45b07a2c54984b69baed377f6f3",
"sha256:7752d58d8f8be537b6ac9a0a521dfc50d5448437b682031e76604a47578bf145",
"sha256:4c18274b6f10bf2ed88c9bbb01268b5593e7c8c6a414987885ff60d55faeafea",
"sha256:96424f280cc6357ac25a313ea5a84b5b878c7806e78b165f7ea0ebc3205d9055",
"sha256:a316c18c6b25f630747f0edec079d0f5fe7c45b37f9aeb5482a1da89256654a6"
]
},
"Metadata": {
"LastTagTime": "0001-01-01T00:00:00Z"
}
}
]