Skip to main content

Set Up the Machine

Follow these steps to set up your machine for running the Hardware Operator. Each step ensures that your environment is correctly configured for optimal performance and compatibility.

1. Hardware Requirements​

Ensure your machine meets the following hardware specifications:

  • Cloud Machine:

    • Architecture: AMD64-based Linux
    • GPU: NVIDIA RTX 40xx series (e.g., RTX 4000)

  • On-Premises Machine:

    • Architecture: AMD64-based Linux
    • GPU: NVIDIA RTX 4070 or RTX 4090

ℹ️ Why: Using the recommended hardware ensures compatibility with our GPU-based prover and optimal performance during operations.

2. CUDA Installation​

The prover software relies on NVIDIA's CUDA for GPU acceleration. Follow these steps to install CUDA:

For the correct installation of NVIDIA drivers and CUDA on your specific hardware and operating system, please consult the official NVIDIA documentation. This will ensure you have the right driver version for your machine.

warning

There is a possibility that CUDA version 11.5 might be installed. However, modern GPUs of the 40xx series and above require compute_89, which is supported only from CUDA Toolkit version 12 onwards. Please ensure you install the appropriate CUDA version.

After installation, you can verify that CUDA is correctly set up by checking the availability and version of the NVIDIA CUDA compiler (nvcc):

  1. Check if nvcc is available:

    which nvcc

    If nvcc is not found, add it to your PATH:

    echo 'export PATH=/usr/local/cuda/bin:$PATH' >> ~/.bashrc
    source ~/.bashrc

  2. Verify nvcc version:

    nvcc --version

    This command should display the version of CUDA that is currently installed, as shown below:

    cherry@cherry:~$ nvcc --version
    nvcc: NVIDIA (R) Cuda compiler driver
    Copyright (c) 2005-2023 NVIDIA Corporation
    Built on Fri_Jan__6_16:45:21_PST_2023
    Cuda compilation tools, release 12.0, V12.0.140
    Build cuda_12.0.r12.0/compiler.32267302_0

ℹ️ Why: CUDA provides the necessary libraries and drivers to leverage GPU acceleration, which is critical for the performance of the prover software.

3. Docker Installation​

Docker is required to containerize the prover application. Follow these steps to install Docker:

  1. Install Docker:

    Refer to the official Docker Installation Guide for detailed instructions tailored to your Linux distribution.

    For Ubuntu:

    sudo apt-get update
    sudo apt-get install -y docker-ce docker-ce-cli containerd.io
note

in some version docker-buildx does not come installed by default.

To check whether Buildx is currently available on your system:

   docker buildx version

If you see a version (e.g., docker buildx version 0.11.2...), Buildx is installed. If it’s not installed, you’ll see an error like “Unknown command: buildx” or “Cannot connect to the Docker daemon…”.

You can refer to Buildx section for docker-buildx-plugin installation.

  1. Verify Docker Installation:

    Ensure Docker is installed correctly by running:

    sudo docker run hello-world

4. Rust Installation​

Rust is required for building kalypso-cli and kalypso-attestation-prover

  1. Install RUST
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
note

Restart your terminal after this process

5. Risc0 Toolchain Installation​

The prover requires risc0 toolchain to be available.

  1. Download rzup
curl -L https://risczero.com/install | bash
note

Restart your terminal after this process for rzup binary to be available in your path

  1. Install rzup
rzup install
  1. For x86-64 linux, install the C++ toolchains by running
rzup install cpp

5. Restart Machine​

After installing the necessary software and tools, it's recommended to restart your machine to ensure all changes take effect.

sudo reboot

ℹ️ Why: Restarting ensures that all services, especially Docker and NVIDIA drivers, are correctly initialized with the new configurations.

Need Help?

If you encounter any issues or have questions, feel free to reach out to our Telegram channel for assistance.

Happy Setting Up!