DEV Community

Ankit Khandelwal
Ankit Khandelwal

Posted on

Installing CVAT on Fedora - Quick Guide

#linux #tutorial #docker #machinelearning

Documentation lacks instructions for installation on Fedora. So, here is a quick guide.

Complete CVAT Installation for Fedora

1. Install Docker & Docker Compose 

sudo dnf update -y
sudo dnf install -y dnf-plugins-core
Enter fullscreen mode Exit fullscreen mode

For Fedora 41+:

sudo dnf config-manager addrepo --from-repofile=https://download.docker.com/linux/fedora/docker-ce.repo
Enter fullscreen mode Exit fullscreen mode

For Fedora 40 or earlier:

sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo
Enter fullscreen mode Exit fullscreen mode

Install Docker packages:

sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y
sudo systemctl start docker
sudo systemctl enable docker
Enter fullscreen mode Exit fullscreen mode

2. Add Your User to Docker Group (Optional) 

sudo groupadd docker
sudo usermod -aG docker $USER
# Log out and back in for changes to take effect
Enter fullscreen mode Exit fullscreen mode

3. Install Git 

sudo dnf install git -y
Enter fullscreen mode Exit fullscreen mode

4. Clone CVAT 

git clone https://github.com/cvat-ai/cvat
cd cvat
Enter fullscreen mode Exit fullscreen mode

For a specific version:

git clone -b v2.1.0 https://github.com/cvat-ai/cvat
cd cvat
Enter fullscreen mode Exit fullscreen mode

5. Start CVAT 

docker compose up -d
Enter fullscreen mode Exit fullscreen mode

6. Create Superuser 

docker exec -it cvat_server bash -ic 'python3 ~/manage.py createsuperuser'
Enter fullscreen mode Exit fullscreen mode

7. Access CVAT

Open Google Chrome and navigate to:

http://localhost:8080
Enter fullscreen mode Exit fullscreen mode

Log in with your superuser credentials.

Common Commands

Command Purpose
docker compose ps Check container status
docker compose logs -f View live logs
docker compose down Stop all containers
docker exec -t cvat_server python manage.py health_check Health check

Key Points

  • Browser: CVAT only supports Google Chrome
  • Version check: Verify your Fedora version and DNF version compatibility
  • Storage: Data is stored in Docker volumes by default
  • Network access: Set CVAT_HOST environment variable if accessing from other machines

That's it! CVAT is now ready for annotation tasks.

Top comments (0)