Comment on page
🛳
Install with Docker
Xtreme1 can be installed via Docker.
Any OS can install the Xtreme1 platform with Docker Compose (installing Docker Desktop on Mac, Windows, and Linux devices). On the Linux server, you can install Docker Engine with Docker Compose Plugin.
Hardware Requirements
Component | Recommended configuration |
|---|---|
CPU | AMD64 or ARM64 |
RAM | 2GB or higher |
Hard Drive | 10GB+ free disk space (depends on data size) |
Software Requirements
For Mac, Windows, and Linux with desktop:
Software | Version |
|---|---|
Docker Desktop | 4.1 or newer |
For Linux server:
Software | Version |
|---|---|
Docker Engine | 20.10 or newer |
Docker Compose Plugin | 2.0 or newer |
(Built-in) Models Deployment Requirements
⚠
Two built-in models only can be running on Linux server with NVIDIA Driver and NVIDIA Container Toolkit.
Component | Recommended configuration |
|---|---|
GPU | NVIDIA Tesla T4 or other similar NVIDIA GPU |
GPU RAM | 6G or higher |
RAM | 4G or higher |
Download the latest release package and unzip it.
Or using the following command:
wget https://github.com/xtreme1-io/xtreme1/releases/download/v0.7.2/xtreme1-v0.7.2.zip
unzip -d xtreme1-v0.7.2 xtreme1-v0.7.2.zip
Enter into the release package directory, and execute the following command to start all services. It needs a few minutes to initialize database and prepare a test dataset.
docker compose up
You can replace
localhost with IP address if you want to access from another machine.
Screenshot of Docker Desktop
# Start in the foreground.
docker compose up
# Or add -d option to run in the background.
docker compose up -d
# When finished, you can start or stop all or specific services.
docker compose start
docker compose stop
# Stop all services and delete all containers, but data volumes will be kept.
docker compose down
# Danger! Delete all volumes. All data in MySQL, Redis and MinIO.
docker compose down -v
Docker compose will pull all service images from Docker Hub, including basic services
MySQL, Redis, MinIO, and application services backend, frontend. You can find the username, password, hot binding port to access MySQL, Redis and MinIO in docker-compose.yml. For example you can access MinIO console at http://localhost:8194. We use Docker volume to save data, so you won't lose any data between container recreating.Make sure you have installed NVIDIA Driver and NVIDIA Container Toolkit. There is no need to install the CUDA Toolkit, as it is already contained in the model image.
# You need set "default-runtime" as "nvidia" in /etc/docker/daemon.json and restart docker to enable NVIDIA Container Toolkit
{
"runtimes": {
"nvidia": {
"path": "nvidia-container-runtime",
"runtimeArgs": []
}
},
"default-runtime": "nvidia"
}
Please note that certain Docker images, including⚠MySQL, may not be compatible with the ARM architecture. In case your computer is based on an ARM CPU (e.g. Apple M1), you can create a Docker Compose override file calleddocker-compose.override.ymland include the following content. While this method uses QEMU emulation to enforce the use of the ARM64 image on the ARM64 platform, it may impact performance.
services:
mysql:
platform: linux/amd64
Last modified 1mo ago