Skip to content
CARRERA3DCarrera3DJoin Beta

Installation

Download and install Carrera3D on macOS, Windows, or Linux, and verify the download.

Carrera3D is a native desktop app — there’s no browser version. Get the build for your platform from Download.

Builds are not yet signed with an Apple or Microsoft certificate, so the first launch shows an OS warning. The steps below get past it once; after that the app opens normally.

macOS

Requires macOS 11 or later. Pick Apple Silicon for M-series Macs and Intel otherwise.

  1. Open the .dmg and drag Carrera3D into Applications.
  2. Open Carrera3D from Applications. macOS says it could not verify the app — click Done.
  3. Open System Settings → Privacy & Security, scroll to Security, and click Open Anyway next to the Carrera3D message.
  4. Confirm with Open Anyway and your password.

Since macOS Sequoia (15), Control-click → Open no longer skips the warning; use Open Anyway as above. On macOS 14 and earlier, Control-click the app in Applications and choose Open.

If you prefer the terminal, this clears the download quarantine flag instead:

xattr -dr com.apple.quarantine /Applications/Carrera3D.app

Windows

  1. Run Carrera3D-<version>-windows-x64.setup.exe (or windows-arm64 on ARM PCs).
  2. If SmartScreen shows Windows protected your PC, click More info → Run anyway.
  3. Finish the installer.

The installer is per-user: it installs into your own profile (%LOCALAPPDATA%) and needs no administrator rights.

Linux

Requires glibc 2.35 or newer (Ubuntu 22.04+, Debian 12+, Fedora 36+, current Arch) and a GPU with Vulkan support.

AppImage — runs on any of those distributions without installing:

chmod +x Carrera3D-<version>-linux-x64.AppImage
./Carrera3D-<version>-linux-x64.AppImage

On Ubuntu, AppImages need FUSE 2: sudo apt install libfuse2 (on 24.04: libfuse2t64).

Packages — install with your package manager so dependencies are pulled in:

# Debian, Ubuntu
sudo apt install ./Carrera3D-<version>-linux-x64.deb
# Fedora, openSUSE
sudo dnf install ./Carrera3D-<version>-linux-x64.rpm
# Arch
sudo pacman -U Carrera3D-<version>-linux-x64.pkg.tar.zst

Use linux-arm64 in the file name on ARM machines.

Updates

Carrera3D checks for updates at startup and every 6 hours, and installs a new version with one click. If you installed a .deb, .rpm or Arch package, the update asks for your admin password through the system prompt.

Verify your download

Every release publishes a SHA256SUMS file. Run the check in the folder you downloaded to; it should print OK.

Linux

curl -LO https://downloads.carrera3d.com/releases/<version>/SHA256SUMS
sha256sum -c --ignore-missing SHA256SUMS

macOS

curl -LO https://downloads.carrera3d.com/releases/<version>/SHA256SUMS
shasum -a 256 -c --ignore-missing SHA256SUMS

Windows (PowerShell)

Get-FileHash .\Carrera3D-<version>-windows-x64.setup.exe

Compare the hash with the matching line in SHA256SUMS (case does not matter).

Updates are verified by the app itself. Every artifact is signed with our own ed25519 key, and Carrera3D refuses to install an update whose signature does not match the public key compiled into it, or whose version is not newer than the one running. The signature covers the version, platform and package type, so an old build cannot be passed off as a new one. The public key, to check independently:

egSCxNDzWEItbNY6yDB9rZUZHyn2ZSKO6OOCssfnbNc=

GPU requirements

Carrera3D renders with wgpu, which needs Metal on macOS, DirectX 12 or Vulkan on Windows, and Vulkan on Linux. Very old or integrated GPUs may not support these.

Connecting to a vault

If your team runs a CarreraVault vault, see Connecting to a CarreraVault vault next.