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.
- Open the
.dmgand drag Carrera3D into Applications. - Open Carrera3D from Applications. macOS says it could not verify the app — click Done.
- Open System Settings → Privacy & Security, scroll to Security, and click Open Anyway next to the Carrera3D message.
- 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
- Run
Carrera3D-<version>-windows-x64.setup.exe(orwindows-arm64on ARM PCs). - If SmartScreen shows Windows protected your PC, click More info → Run anyway.
- 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.