Setting up a dev environment can feel overwhelming at first, especially with tools like Git, WSL, Docker, and SSH. I recently went through this process and wanted to share how I did it β including tips, common mistakes, and useful links to help you avoid frustration.
β What I Installed and Why
Git β for version control and working with repositories
π Download: https://git-scm.com/downloads
Python 3.10+ β needed for scripting and backend development
π Download: https://www.python.org/downloads/
VS Code / PyCharm β code editors for writing and debugging
π VS Code: https://code.visualstudio.com/
π PyCharm: https://www.jetbrains.com/pycharm/download/
WSL (Windows Subsystem for Linux) β for Linux tooling on Windows
π Guide: https://learn.microsoft.com/en-us/windows/wsl/install
Docker β to run containers and keep dev environments clean
π Download: https://www.docker.com/products/docker-desktop/
SSH with GitHub β to connect to GitHub securely
π Guide: https://docs.github.com/en/authentication/connecting-to-github-with-ssh
π§ Step-by-Step Setup
- Git and SSH
Installed Git and configured my name and email:
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
Generated SSH keys:
ssh-keygen -t ed25519 -C "you@example.com"
Added my public key to GitHub via Settings β SSH & GPG keys
Started the SSH agent and added the key:
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
- Python and Code Editors
Installed Python 3.10+ and verified the version:
python --version
Installed PyCharm for heavy projects, and VS Code for lighter edits
Set up a virtual environment:
python -m venv venv
source venv/bin/activate # On Linux/macOS
.\venv\Scripts\activate # On Windows
- WSL (for Windows Users)
Enabled WSL by running:
wsl --install
Downloaded Ubuntu from the Microsoft Store
Updated and installed essentials:
sudo apt update && sudo apt upgrade
sudo apt install python3 python3-pip git
- Docker
Installed Docker Desktop and enabled WSL 2 integration
Tested Docker installation:
docker run hello-world
β οΈ What Went Wrong (And How I Fixed It)
SSH wouldnβt connect β I forgot to start the SSH agent
Docker didnβt work β WSL was not set to version 2
Wrong Python version β I was using Windows Python instead of WSLβs
These challenges helped me understand the tools better and troubleshoot on my own.
π‘ Helpful Extras
Installed VS Code extensions: Python, Docker, GitLens, Remote - WSL
Added some Git aliases for speed:
git config --global alias.st status
git config --global alias.ci "commit -m"
π― Final Thoughts
After setting all this up, I now have a complete dev environment that allows me to:
Build and test apps easily
Use Linux tools while staying on Windows
Push to GitHub securely using SSH
Run isolated projects in Docker containers
It might seem like a lot at first, but every step taught me something useful. If youβre just getting started, take your time and embrace the errors β theyβre part of the process
Top comments (1)
perfect!