Skip to main content

Environment Setup

This section will guide you through the basic environment configuration, including Docker installation and necessary system settings.

Installing Docker​

Docker is the core component for running Mytesla services. We need to install Docker Engine and Docker Compose.

Linux Systems​

Ubuntu/Debian Systems​

# Update package manager
sudo apt update && sudo apt upgrade -y

# Install necessary dependency packages
sudo apt install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg \
    lsb-release \
    wget \
    git

# Add Docker official GPG key
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# Add Docker repository
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Install Docker Engine
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

# Add current user to docker group
sudo usermod -aG docker $USER

# Start and enable Docker service
sudo systemctl start docker
sudo systemctl enable docker

CentOS/RHEL Systems​

# Install necessary packages
sudo yum install -y yum-utils device-mapper-persistent-data lvm2

# Add Docker repository
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

# Install Docker Engine
sudo yum install -y docker-ce docker-ce-cli containerd.io

# Start and enable Docker service
sudo systemctl start docker
sudo systemctl enable docker

# Add current user to docker group
sudo usermod -aG docker $USER

macOS Systems​

  1. Visit Docker Desktop for Mac official website
  2. Download the version suitable for your processor architecture (Intel or Apple Silicon)
  3. Install and start Docker Desktop
  4. Ensure Docker Desktop is running

Windows Systems​

  1. Ensure WSL2 feature is enabled
  2. Visit Docker Desktop for Windows official website
  3. Download and install Docker Desktop
  4. Start Docker Desktop and ensure it uses WSL2 engine

🔧 Installing Docker Compose​

Linux Systems​

# Download the latest version of Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# Add execute permissions
sudo chmod +x /usr/local/bin/docker-compose

# Create symbolic link (optional)
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

macOS/Windows​

Docker Desktop already includes Docker Compose, no separate installation needed.

Verify Installation​

After logging back into the system (or executing newgrp docker ), verify the installation was successful:

# Check Docker version
docker --version

# Check Docker Compose version
docker-compose --version

# Test if Docker is working properly
docker run hello-world

# Check Docker service status
docker system info

Expected output similar to:

Docker version 24.0.x, build xxxxx
Docker Compose version v2.20.x
Hello from Docker!
...

Create Project Directory​

Create a dedicated directory to store Mytesla related files:

# Create project directory
mkdir -p ~/mytesla
cd ~/mytesla

Common Issues​

Permission denied​

If you encounter permission errors:

# Ensure user is in docker group
sudo usermod -aG docker $USER

# Re-login or execute
newgrp docker

Docker service cannot start​

# Check service status
sudo systemctl status docker

# View detailed logs
sudo journalctl -u docker.service

Port already in use​

# Check port usage
sudo netstat -tlnp | grep :4000

# Stop process using the port
sudo kill -9 <PID>