How to Set Up Your Computer for Coding (Step-by-Step for Beginners)
You need four things installed: VS Code (your code editor), Git (version control), Node.js (to run JavaScript), and a basic understanding of your terminal. On a decent connection, the whole setup takes under an hour. If your internet is slow or expensive, download offline installers from a cyber cafe. That is it. Do not install Docker, databases, or anything else on day one.
Why Setup Matters (But Should Not Take All Day)
Some beginners spend an entire weekend "setting up" before they write a single line of code. They install fifteen VS Code extensions, configure themes, customise their terminal prompt, and debate which font makes code look best. Then they are exhausted and never actually start coding.
Do not be that person. Setup is a five-step checklist, not a project. The goal is a working environment where you can write code, save files, and see the results. Everything else is decoration you can add later when you actually need it.
This article is the short funnel version. It gives you exactly what you need to get started and nothing more. If you want the full deep-dive with extension recommendations, advanced configuration, and troubleshooting for common issues, read our complete coding environment setup guide.
Step 1: Install VS Code (Your Code Editor)
VS Code is a free code editor made by Microsoft. It is what the vast majority of professional developers use daily. It runs on Windows, macOS, and Linux.
What to do:
- Go to
code.visualstudio.com - Download the installer for your operating system
- Run the installer with the default settings
- Open VS Code and make sure it launches
That is it for now. Do not install extensions yet. The default setup is enough to write HTML, CSS, and JavaScript. You can add extensions later when you know what you actually need.
Kenya-specific tip: If your internet is slow or expensive, the VS Code download is about 100MB. If that is a problem on your connection, go to a cyber cafe, download the installer to a flash drive, and install at home. The offline installer works perfectly. You do not need an internet connection to use VS Code after installation.
Step 2: Install Git (Version Control)
Git tracks changes to your code. Think of it as "undo history" that works across files and never disappears. Every professional developer uses Git. You will need it from week one.
What to do:
- Go to
git-scm.comand download the installer - Run the installer. Accept the defaults. Seriously, just click Next until it finishes.
- Open your terminal and type:
git --version - If you see a version number, Git is installed
After installing, set your identity so Git knows who is making changes:
git config --global user.name "Your Name"
git config --global user.email "your@email.com"
Then create a free account at github.com. GitHub is where your code will live online. It is also what employers look at when they want to see your work.
Note for macOS users: Git comes pre-installed on most Macs. Open Terminal and type git --version. If it prompts you to install developer tools, say yes and you are done.
Step 3: Install Node.js (JavaScript Runtime)
Node.js lets you run JavaScript outside of a web browser. You need it for most modern web development, and it also installs npm (Node Package Manager), which you will use to add libraries to your projects.
The recommended way: Install Node.js through nvm (Node Version Manager). This lets you switch between Node versions later without breaking anything.
On macOS or Linux:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
Close and reopen your terminal, then:
nvm install --lts
node --version
On Windows: Download nvm-windows from the GitHub releases page (github.com/coreybutler/nvm-windows/releases). Install it, then open a new command prompt and run:
nvm install lts
nvm use lts
node --version
The quick-and-dirty way: If nvm feels like too much right now, just go to nodejs.org and download the LTS version directly. It works. You can switch to nvm later when you need multiple versions.
Kenya-specific tip: The Node.js installer is about 30MB. The nvm install script itself is tiny, but downloading Node through nvm still needs a stable connection. If your internet is unreliable, download the .msi (Windows) or .pkg (macOS) installer from nodejs.org at a cyber cafe and install offline.
Step 4: Learn 5 Terminal Commands
The terminal (also called command line or shell) looks intimidating, but you only need a handful of commands to get started. Here are the five that will carry you through your first few months:
cd folder-name— move into a foldercd ..— move back one folderls(macOS/Linux) ordir(Windows) — list files in the current foldermkdir folder-name— create a new foldercode .— open the current folder in VS Code
That is genuinely all you need right now. You are not becoming a systems administrator. You are learning enough to navigate to your project folder and open it. The rest you will pick up naturally as you code.
Where to find your terminal:
- Windows: Search for "PowerShell" or "Command Prompt" in the Start menu. Or press
Ctrl + `inside VS Code to open the built-in terminal. - macOS: Open "Terminal" from Applications > Utilities. Or press
Cmd + `inside VS Code. - Linux: You probably already know. But if not, search for "Terminal" in your application menu.
Pro tip: VS Code has a built-in terminal. Press Ctrl + ` (Windows/Linux) or Cmd + ` (macOS) to open it. This means you can write code and run commands in the same window. Most developers work this way.
What NOT to Install Yet
Beginners often see tutorials that tell them to install Docker, PostgreSQL, MongoDB, Python, Ruby, multiple frameworks, and a dozen VS Code extensions before lesson one. Ignore all of that for now.
Do not install yet:
- Docker (you will not need containers for months)
- Databases like PostgreSQL or MongoDB (you will add these when your projects need them)
- Python (unless your learning path specifically starts with Python instead of JavaScript)
- Any CSS framework or JavaScript framework (React, Vue, etc. come later)
- More than 2 or 3 VS Code extensions (the defaults are fine)
Every tool you install before you need it is a tool that can break, need updating, or confuse you. Install things when your project requires them, not when a YouTube thumbnail tells you to.
Test Your Setup in 60 Seconds
Let us make sure everything works. Open your terminal and run each of these:
code --version
git --version
node --version
npm --version
If all four print a version number, your setup is complete. You are ready to code.
If something is not working, the most common fixes are: close and reopen your terminal (some installations need a fresh terminal session), restart your computer (yes, seriously), or check that the installer actually finished without errors.
What Comes After Setup
Your computer is ready. The next question is what to learn and in what order. If you have not already, read what to do before you start coding. The short version: understand how the web works before writing code. It saves you months of confusion later.
If you want the complete setup guide with recommended VS Code extensions, Git workflow basics, and troubleshooting for common installation problems, read our full coding environment setup guide.
And if you are ready to start learning but want a structured path that covers the foundations most tutorials skip, create a free McTaba Academy account and preview the first few lessons. If the material clicks, Tech Foundations: Before You Code (KES 2,999) covers everything you need to understand before writing your first real project. It is designed for people who just finished setting up their computer and are wondering "now what?"
Key Takeaways
- ✓You only need four tools to start: VS Code, Git, Node.js, and your terminal. Everything else can wait.
- ✓The entire setup takes 30 minutes to 2 hours depending on your internet speed. If your connection is slow, download offline installers from a cyber cafe or a friend with better bandwidth.
- ✓Do not install Docker, databases, or advanced tools on day one. They will make sense later. Right now they will only slow you down and eat disk space.
- ✓Learning 5 to 10 terminal commands is enough for your first few months. You do not need to become a command-line expert before writing your first line of code.
- ✓For the full deep-dive with extensions, configurations, and troubleshooting, see our complete coding environment setup guide in the Coding hub.
Frequently Asked Questions
- Can I use a different code editor instead of VS Code?
- Yes, but VS Code is the standard for good reasons: it is free, lightweight, works on every operating system, and has the largest ecosystem of extensions and community support. If you are starting from scratch, there is no practical reason to use anything else. Sublime Text and WebStorm are fine alternatives if you already have a preference, but do not overthink this.
- Do I need a fast internet connection to set up my coding environment?
- No. Every tool mentioned in this guide has an offline installer. If your home internet is slow, go to a cyber cafe or a friend with a better connection, download the installers to a flash drive, and install at home. The total download size for VS Code, Git, and Node.js is under 200MB combined. After installation, you do not need internet to write and run code locally.
- Should I use Windows, macOS, or Linux for coding?
- All three work fine. Use whichever operating system is already on your computer. If you are on Windows, use PowerShell or the Windows Terminal. If you are on macOS, the built-in Terminal works perfectly. Do not reinstall your operating system or buy a new computer just to start coding. The differences between operating systems matter very little at the beginner level.
- What if one of the installations fails?
- The most common fix is closing your terminal and opening a fresh one. Many installations add commands to your system PATH, which only takes effect in new terminal sessions. If that does not work, restart your computer. If you are still stuck, search the exact error message online. Installation issues are extremely common and almost always have a Stack Overflow answer. Our full setup guide in the Coding hub covers the most common failure points in detail.
- How much storage space do I need for coding tools?
- VS Code uses about 300MB, Git is under 50MB, and Node.js is about 100MB. In total, you need roughly 500MB of free space to get started. That is well within what most laptops have available. As you build projects and install libraries, you will use more space, but you will not hit storage problems for a long time unless your hard drive is nearly full.
Ready to build real-world apps?
Join the McTaba Labs full-stack marathon (4 months full-time · 6 months part-time). Learn M-Pesa, USSD, and WhatsApp engineering while shipping 8 production apps.
Apply to the McTaba Marathon