Platform Requirements

When submitting jobs to Auralis, you need to choose the right platform for your Docker image. This page explains the differences and helps you pick.

What is a Platform?

A platform refers to the CPU architecture your code is built for. The two main platforms are:

• AMD64 (also called x86_64) – Intel and AMD processors
• ARM64 (also called aarch64) – Apple Silicon, AWS Graviton, Raspberry Pi

Your Docker image must match the platform of the machine running it.

Which Platform Should I Choose?

Choose AMD64 if:

• You're running on Windows with Intel/AMD CPU
• You're on an older Mac (pre-2020)
• You're deploying to most cloud VMs (AWS EC2, GCP, Azure)
• You're unsure (AMD64 is the most common)

Choose ARM64 if:

• You're on a Mac with Apple Silicon (M1, M2, M3, M4)
• Your Docker image was built on an ARM machine
• You specifically need ARM64 for compatibility

How Platform Matching Works

When you submit a job, you select a platform. Only workers with matching platforms will see your job:

You submit AMD64 job → Only AMD64 workers can run it
You submit ARM64 job → Only ARM64 workers can run it

This prevents failed jobs due to architecture mismatches.

Auto-Detection

Auralis automatically detects your platform in the browser:

• Submit page: Pre-selects your platform
• Provide page: Registers your worker with the correct platform

You can always change the selection if needed.

Building for a Specific Platform

If you need to build an image for a different platform than your machine, use Docker's --platform flag:

# Build for AMD64 on an ARM machine
docker build --platform linux/amd64 -t my-image .
 
# Build for ARM64 on an AMD machine
docker build --platform linux/arm64 -t my-image .

Or use docker buildx for cross-platform builds:

docker buildx build --platform linux/amd64,linux/arm64 -t my-image .

Common Issues

"Image not compatible"

Your Docker image was built for a different platform. Rebuild with the correct --platform flag.

"No jobs available"

If you're a provider and see no jobs, it might be because all pending jobs are for the other platform. Wait for matching jobs or check the public job queue.

Slow builds on M1/M2 Macs

Cross-compiling AMD64 images on ARM Macs uses emulation and is slower. For local testing, build for ARM64. For production or Auralis, build for the target platform.

Summary

When in doubt, start with AMD64 – it's the most widely supported.