Installation Guide
Welcome to the PrestaShop Enterprise Developer Tools installation guide. This comprehensive guide will help you set up a complete development environment for PrestaShop Enterprise development.
What You’ll Install
The PrestaShop Enterprise Developer Tools is a powerful Command Line Interface (CLI) that provides:
- Local Environment Management: Clone, configure, and run PrestaShop shops locally
- Database Management: Dump and sync remote databases for testing
- Module Development: Tools for PrestaShop module development and compliance checking
- Environment Switching: Easily switch between different Enterprise environments
- Automated Workflows: Streamline repetitive development tasks
Before You Begin
System Requirements Overview
All supported operating systems require:
- Minimum 8 GB RAM (16 GB recommended)
- 10 GB free disk space minimum
- Stable internet connection for downloads and repository access
- PrestaShop Enterprise Platform account
Prerequisites Summary
Each operating system requires specific software:
| Component |
Windows |
macOS |
Ubuntu |
| Container Platform |
Docker Desktop + WSL2 |
Docker Desktop |
Docker + Docker Compose |
| Version Control |
Git for Windows |
Git (via Homebrew) |
Git (apt package) |
| Package Manager |
PowerShell (built-in) |
Homebrew (recommended) |
APT (built-in) |
| Additional Requirements |
Windows Terminal |
Xcode Command Line Tools |
Build essentials |
Choose Your Operating System
Select your operating system below for detailed installation instructions:
Windows
Windows 10/11 with WSL2 support
Complete setup with PowerShell and Git Bash
Windows Installation
Installation Overview
Each installation guide follows the same structured approach:
1. Prerequisites Setup
- Install and configure Docker for containerization
- Set up Git with SSH key authentication
- Configure system-specific requirements
- Download the platform-specific binary
- Install the tools system-wide
- Verify successful installation
3. Initial Configuration
- Authenticate with PrestaShop Enterprise Platform
- Configure your development environment
- Set up your first project
4. Verification & Testing
- Test all components are working correctly
- Verify connectivity to repositories
- Run initial health checks
What to Expect
Installation Time
- First-time setup: 30-45 minutes (including downloads)
- Prerequisites only: 20-30 minutes
- Tools installation: 5-10 minutes
Downloads Required
- Docker Desktop/Engine (~500 MB - 1 GB)
- Git and related tools (~100-200 MB)
- PrestaShop Enterprise Tools (~50 MB)
- Initial Docker images (~1-2 GB during first run)
Getting Help
Common Installation Issues
Most installation issues fall into these categories:
- Docker Setup Problems: Usually related to permissions or WSL2 configuration
- SSH Key Issues: Often due to incorrect key generation or GitLab configuration
- Network Connectivity: Firewall or proxy configurations blocking downloads
- System Permissions: User account lacking administrative privileges
Support Resources
- Detailed Troubleshooting: Each OS-specific guide includes comprehensive troubleshooting sections
- System Verification: Built-in commands to test your installation
- Community Support: Connect with other PrestaShop developers
- Enterprise Support: Contact your PrestaShop Enterprise support team
Quick Start After Installation
Once you’ve completed the installation for your operating system:
- Open your terminal (PowerShell, Terminal, or Bash)
- Navigate to your project directory:
mkdir ~/prestashop-development
cd ~/prestashop-development
- Run the developer tools:
- Follow the interactive setup to configure your first project
Next Steps
After successful installation:
- 📖 Read the Usage Guide for project setup and workflows
- 🛠️ Explore Commands for command reference
- 🚀 Start your first PrestaShop Enterprise project
New to PrestaShop Enterprise Development?
Start with the installation guide for your operating system, then proceed to the
Usage Guide for a complete walkthrough of setting up your first project.
Already Have Docker and Git?
You can jump directly to the “Installation” section of your OS-specific guide to install just the PrestaShop Enterprise Developer Tools.