Skip to main content

Prerequisites

Before starting the deployment, please ensure you meet the following requirements.

Hardware Requirements

ItemMinimum RequirementsRecommended Configuration
CPU2 cores4 cores or more
Memory2GB4GB or more
Storage50GB available space100GB or more
NetworkStable internet connectionUpload bandwidth ≥ 10Mbps
Performance Notes
  • TeslaMate database will grow over time, recommend reserving sufficient storage space
  • More memory helps with database query performance
  • Stable network connection ensures real-time data synchronization

Operating System Support

  • Ubuntu 20.04 LTS or newer
  • Debian 10 or newer
  • CentOS 7 or newer
  • RHEL 7 or newer

Other Systems

  • macOS 10.15 Catalina or newer
  • Windows 10/11 (requires WSL2)
Why recommend Linux?

Linux systems are more stable for server deployment, use fewer resources, and Docker performance is better.

Required Conditions

  • Tesla owner account - You need to own a Tesla vehicle
  • Vehicle access permissions - Ensure you can control the vehicle through the mobile app
  • API tokens - Used for TeslaMate to connect to Tesla services

Getting API Tokens

Important Note

Tesla's official API token acquisition method may change. Please refer to TeslaMate official documentation for the latest information.

🛠️ Technical Skill Requirements

Beginner Users

  • ✅ Able to copy and paste commands
  • ✅ Can edit text files
  • ✅ Can follow documentation instructions

Advanced Users

  • ✅ Familiar with Linux command line
  • ✅ Understanding of Docker basics
  • ✅ Basic networking knowledge

🌐 Network Requirements

Basic Network

  • Internet connection - Download images and access APIs
  • Domain resolution - Access Tesla and third-party services
  • Firewall - Ensure necessary ports are accessible

Port Usage

The following ports will be used (can be modified in configuration):

ServicePortPurpose
TeslaMate4000Web interface
Grafana3000Data visualization
TeslaMateAPI8080API service
PostgreSQL5432Database (internal)
MQTT1883Message queue (internal)