developer-environment-setup

📦 Complete Installation Guide

This guide provides step-by-step instructions to set up your complete development environment.

Table of Contents

  1. System Requirements
  2. Automated Setup (Recommended)
  3. Manual Installation
  4. Verification
  5. Troubleshooting

System Requirements

Minimum Requirements

Optional Requirements

Step 1: Clone the Repository

Open PowerShell and run:

git clone https://github.com/devanjaniraj/developer-environment-setup.git
cd developer-environment-setup

Step 2: Enable Execution Policy

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

Step 3: Run Setup Script

.\scripts\setup.ps1

Or with options:

# Skip Docker installation
.\scripts\setup.ps1 -SkipDocker

# Skip VS Code extensions
.\scripts\setup.ps1 -SkipExtensions

# Quiet mode (no output)
.\scripts\setup.ps1 -Quiet

Step 4: Restart PowerShell

Close and reopen PowerShell to apply all environment changes.

Step 5: Verify Installation

.\scripts\verify-installation.ps1

Manual Installation

If the automated script fails, follow these steps manually:

1. Install Node.js

  1. Visit https://nodejs.org/ (LTS version)
  2. Download the Windows installer (64-bit)
  3. Run the installer
  4. Check “Add to PATH” during installation
  5. Complete installation

Verify:

node --version
npm --version

2. Install Python

  1. Visit https://www.python.org/downloads/
  2. Download Python 3.11 or later
  3. Run the installer
  4. Important: Check “Add Python to PATH” ✓
  5. Click “Install Now”

Verify:

python --version
pip --version

3. Install Git

  1. Visit https://git-scm.com/download/win
  2. Download the latest version (64-bit)
  3. Run the installer
  4. Keep default options
  5. Click through installation

Verify:

git --version

4. Install Docker Desktop

  1. Visit https://www.docker.com/products/docker-desktop
  2. Download Docker Desktop for Windows
  3. Run the installer
  4. Choose installation type (Hyper-V or WSL 2)
  5. Complete installation
  6. Restart computer

Verify:

docker --version
docker run hello-world

5. Install VS Code

  1. Visit https://code.visualstudio.com/
  2. Download for Windows (64-bit)
  3. Run the installer
  4. Check “Add to PATH” ✓
  5. Complete installation

Verify:

code --version

6. Install VS Code Extensions

Option A - Automated:

.\scripts\setup.ps1 -SkipExtensions:$false

Option B - Manual:

code --install-extension ms-python.python
code --install-extension ms-vscode.cpptools
code --install-extension ms-vscode-remote.remote-containers
code --install-extension dbaeumer.vscode-eslint
code --install-extension esbenp.prettier-vscode
code --install-extension GitHub.copilot
code --install-extension ms-azuretools.vscode-docker

Configuration

Configure Git User

git config --global user.name "Your Name"
git config --global user.email "Kanjanikumar52@gmail.com"
git config --global core.editor "code --wait"

Configure Python Virtual Environment

# Create virtual environment
python -m venv venv

# Activate it
venv\Scripts\activate

# Deactivate when done
deactivate

Start Docker Databases

cd developer-environment-setup
docker-compose up -d

Verification

Quick Verification

node -v      # Should show v20.11+
npm -v       # Should show 10.5+
python -v    # Should show 3.11+
git -v       # Should show 2.40+
docker -v    # Should show 29.0+

Comprehensive Verification

Run the verification script:

.\scripts\verify-installation.ps1

Common Issues

Issue: Command Not Found

Solution:

  1. Close all PowerShell windows
  2. Open new PowerShell window
  3. Restart your computer
  4. Try command again

Issue: PowerShell Execution Policy Error

Solution:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

Issue: Docker Won’t Start

Solution:

  1. Make sure Docker Desktop is running
  2. Check if Hyper-V is enabled
  3. Restart Docker Desktop
  4. Restart your computer

Issue: npm install fails

Solution:

npm cache clean --force
npm install

Next Steps

  1. Create a Project: See QUICK_START.md
  2. Learn Node.js: See NODEJS_SETUP.md
  3. Learn Python: See PYTHON_SETUP.md
  4. Configure Docker: See DOCKER_SETUP.md
  5. Setup Git: See GIT_SETUP.md

Support

This site is open source. Improve this page.