This section provides step-by-step instructions to install the GRID Enterprise on your system if you chose to go with the self-hosted offering. The GRID Enterprise is designed to work seamlessly on systems with the following requirements.

​
Requirements

Before proceeding with the installation, ensure that your system meets the following requirements:
  • Operating System:
    Ubuntu 22.04 / 24.04
    The GRID Enterprise is optimized for Ubuntu 22.04 and 24.04, ensuring compatibility with the latest Linux distributions. While it may work on other versions or distributions, these are the officially supported versions.
  • NVIDIA GPU + Drivers:
    To leverage GRID’s simulation and AI models, an NVIDIA GPU is required, with a VRAM of at least 8 GB (ideally ≥16 GB). Ensure the latest NVIDIA drivers (535+) are installed.
  • Docker:
    Docker is used to containerize applications, ensuring that the GRID Enterprise runs consistently across different environments. Make sure Docker is installed and running on your system. Learn more.
  • NVIDIA Container Runtime:
    The NVIDIA container runtime is required to run GPU-accelerated Docker containers. This runtime allows Docker to utilize the GPU, enabling efficient execution of AI models within containers. Refer to the NVIDIA Container Toolkit Installation Guide.
    For simplicity, we recommend installing it with Apt. Configuration is automatic as detected by Docker.
  • Python 3.11+:
    The GRID Enterprise requires Python 3.11 or higher. We recommend installing through Miniconda or an equivalent environment manager.

​
Installation Steps

GRID Enterprise is set up and accessed through a Python based command console. Once the prerequisites are set up on your system, you can install the GRID Enterprise console with the following command inside your conda/virtual environment: 
conda create -n grid python=3.11
conda activate grid
pip install sf-grid

​
License Configuration

If you received a configuration file as part of your onboarding (which takes the form of a resource_config.json file), please first copy the file to the following path on your machine: ~/.grid/resource_config.json. 
mkdir -p ~/.grid
cp /path/to/resource_config.json ~/.grid/resource_config.json

​
Getting Started

Now that you have installed the GRID Enterprise, you can start using the GRID CLI by running the following command: 
grid

  .d8888b.  8888888b.  8888888 8888888b.  
 d88P  Y88b 888   Y88b   888   888  "Y88b 
 888    888 888    888   888   888    888 
 888        888   d88P   888   888    888 
 888  88888 8888888P"    888   888    888 
 888    888 888 T88b     888   888    888 
 Y88b  d88P 888  T88b    888   888  .d88P 
  "Y8888P88 888   T88b 8888888 8888888P"  

 Enter your username: <username>
 Enter your password: ********
 Enter your storage token: <storage_token>
 Resource configuration file created successfully.
 Loading resource configuration from /home/user/.grid/resource_config.json...
 General Robot Intelligence Development Platform Console 
 Developed by General Robotics, Inc.

 Type 'help' or 'license' for more info.
This command initializes the GRID CLI.
If you have not pre-provided a configuration file, the CLI will prompt you to manually enter credentials (username, password, and storage token).
Once installed, proceed to the next section to learn more about the GRID CLI and its commands.