Skip to main content

​
🚀 DevOps Engineer Mac Setup Documentation

This document captures the full setup we’ve done so far on your macOS system.

​
1. 🔧 Core Tools Installed with Homebrew

We used Homebrew to install base utilities: 
brew install git wget curl jq yq tree htop watch gnu-sed gawk coreutils findutils

​
Purpose:

  • git → version control
  • jq / yq → JSON/YAML parsing
  • htop, watch → system/process monitoring
  • GNU tools (sed, awk, etc.) → more powerful versions than macOS defaults

​
2. 🐳 Docker Setup

​
Problem:

Running docker ps gave: 
Cannot connect to the Docker daemon at unix:///var/run/docker.sock.

​
Solution:

  • Installed Docker Desktop (daemon + GUI) via Homebrew: 
    brew install --cask docker
  • Alternative: Colima for a lightweight Docker runtime: 
    brew install colima
colima start

​
3. 🌐 Browsers & Terminals

Installed additional tools: 
brew install --cask arc terminus warp
  • Arc Browser → modern web browser
  • Terminus → customizable terminal
  • Warp → AI-powered modern terminal (popular in DevOps)

​
4. 🛠 Oh My Zsh & Zsh Customization

​
Install Oh My Zsh

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
This sets Zsh as the default shell and installs config in ~/.oh-my-zsh.

​
5. 🎨 Powerlevel10k Theme Setup

The default robbyrussell or agnoster themes looked boring. We installed Powerlevel10k, which is the modern DevOps choice.

​
Install Powerlevel10k into Oh My Zsh

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git \
  ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

​
Update ~/.zshrc

ZSH_THEME="powerlevel10k/powerlevel10k"

​
Reload Zsh

exec zsh
This triggered the Powerlevel10k configuration wizard, which saved settings into: 
~/.p10k.zsh

​
6. 🖌 Fonts for Icons/Glyphs

Installed Nerd Fonts for proper icons: 
brew install --cask font-meslo-lg-nerd-font
This ensures Powerlevel10k glyphs (e.g., git icons, arrows, kube symbols) render correctly.

​
7. 📦 Languages & Runtimes

​
Node.js (20, 22, 24 via NVM)

brew install nvm
mkdir ~/.nvm
Add to ~/.zshrc: 
export NVM_DIR="$HOME/.nvm"
[ -s "$(brew --prefix nvm)/nvm.sh" ] && \. "$(brew --prefix nvm)/nvm.sh"
Then install versions: 
nvm install 20
nvm install 22
nvm install 24
nvm alias default 22

​
Go

brew install go

​
Python 3.10 (via pyenv)

brew install pyenv
pyenv install 3.10.14
pyenv global 3.10.14

​
8. 🗄 Database Tools

Installed GUIs: 
brew install --cask mysqlworkbench pgadmin4
  • MySQL Workbench → MySQL management
  • pgAdmin4 → PostgreSQL management

​
9. ⚡ Verification

  • Docker works after running Docker Desktop (or Colima).
  • exec zsh loads Powerlevel10k prompt.
  • Fonts/icons render correctly with Nerd Font.
  • Node, Go, Python versions installed and switchable.
  • Database GUIs installed.

​
🔮 Next Steps

  • Add zsh plugins for better productivity: 
    # In ~/.zshrc
plugins=(
  git
  zsh-autosuggestions
  zsh-syntax-highlighting
)
  • Install them via: 
    brew install zsh-autosuggestions zsh-syntax-highlighting
  • To re-run Powerlevel10k wizard: 
    p10k configure
👉 Do you want me to extend this doc into a step-by-step script (so you can set up a new Mac in one go), or keep it as reference notes? Got it ✅ — I went through our full conversation from top to bottom and extracted every tool, language, runtime, and app we installed (or planned to install). Here’s the consolidated list:

​
📦 Installed Tools & Applications (from our setup)

​
🔧 Core Utilities

  • git
  • wget
  • curl
  • jq (JSON parser)
  • yq (YAML parser)
  • tree
  • htop
  • watch
  • gnu-sed
  • gawk
  • coreutils
  • findutils

​
🐳 Containers & Orchestration

  • docker (CLI)
  • Docker Desktop (daemon + GUI)
  • colima (lightweight Docker alternative – optional)
  • docker-compose
  • kubectl
  • kubectx / kubens
  • stern
  • helm
  • kind
  • k9s
  • minikube

​
☁️ Cloud & IaC

  • awscli
  • azure-cli
  • google-cloud-sdk
  • terraform
  • opentofu

​
🔐 Security & Networking

  • nmap
  • httpie
  • curlie
  • mitmproxy
  • wireguard-tools

​
🛠 Monitoring & Observability

  • promtool (Prometheus tool)
  • grafana-loki

​
📦 Package & Language Managers

  • pyenv (Python versions)
  • pipx
  • nvm (Node version manager)
  • nodenv (alternative Node version manager)
  • goenv (Go version manager)

​
🖥️ Terminals & Shell

  • iterm2
  • warp
  • terminus
  • oh-my-zsh (framework)
  • powerlevel10k (theme)
  • MesloLGS Nerd Font (for icons/glyphs)

​
⚡ Zsh Plugins

  • zsh-autosuggestions
  • zsh-syntax-highlighting
  • zsh-completions

​
🎨 IDEs & Editors

  • visual-studio-code
  • cursor (AI-powered IDE fork of VS Code)

​
🌐 Browsers

  • arc
  • google-chrome

​
📬 Communication

  • slack
  • microsoft-outlook
  • thunderbird

​
🎵 Media & Productivity

  • spotify
  • vlc
  • google-drive
  • dropbox
  • rectangle (window manager)
  • alfred (productivity launcher)
  • itsycal (calendar)
  • notion
  • zoom

​
🗄️ Database Tools

  • mysqlworkbench
  • pgadmin4

​
🛠 Languages & Runtimes

  • Node.js (20, 22, 24 via nvm)
  • Go
  • Python 3.10 (via pyenv)
👉 This is the complete list of everything we’ve installed or configured in this chat. Do you want me to turn this into a categorized “Mac DevOps Bootstrap Script” (one shell script that installs everything in one go)?

​
🔑 macOS SSH Key Setup (with Keychain)

When connecting to Bitbucket/GitHub/GitLab via SSH, you might see: 
Permission denied (publickey).
This happens because your SSH agent has no key loaded.

​
1. Generate an SSH Key (if you don’t already have one)

ssh-keygen -t ed25519 -C "ahmad.raza@example.com" -f ~/.ssh/ahmad.raza@example.com
This creates:
  • Private key → ~/.ssh/ahmad.raza@example.com
  • Public key → ~/.ssh/ahmad.raza@example.com.pub

​
2. Add Key to macOS Keychain

ssh-add --apple-use-keychain ~/.ssh/ahmad.raza@example.com
Check if loaded: 
ssh-add -l

​
3. Configure ~/.ssh/config

Edit (or create) the file: 
nano ~/.ssh/config
Add: 
Host bitbucket.org
    HostName bitbucket.org
    User git
    IdentityFile ~/.ssh/ahmad.raza@example.com
    UseKeychain yes
    AddKeysToAgent yes
💡 This ensures:
  • The key auto-loads into Keychain.
  • Git automatically uses this key for Bitbucket.

​
4. Upload Public Key to Bitbucket

Copy your key: 
cat ~/.ssh/ahmad.raza@example.com.pub
Go to Bitbucket → Personal Settings → SSH Keys → Add Key → paste it.

​
5. Test Connection

ssh -T git@bitbucket.org
Expected output: 
authenticated via ssh key.
You can use git to connect to Bitbucket!

​
6. (Optional) Linux Setup

If using Linux, add this to ~/.bashrc or ~/.zshrc: 
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/ahmad.raza@example.com

​
✅ Executive Summary

  • Problem: SSH agent had no key → “Permission denied”.
  • Fix: Load key with ssh-add and persist via Keychain.
  • Best Practice: Use ~/.ssh/config + Keychain → no more manual ssh-add.

​
Butbucket Setup Mac : (If SSH Key is not working)

It worked because before, your SSH agent had no key loaded, so when git tried to connect to git@bitbucket.org, it sent zero valid identities → Bitbucket rejected with Permission denied (publickey). When you ran: ssh-add ~/.ssh/ahmad.raza@org-name.co.in you explicitly loaded that private key into the running ssh-agent. Now: ssh-agent remembers the key in memory. When git makes an SSH connection, the agent presents the key to Bitbucket. Bitbucket checks the public half of that key against what you uploaded to your account, matches it, and lets you in. ✅ Why you needed ssh-add On macOS (and Linux if not configured), SSH keys aren’t auto-loaded into the agent at login. That’s why ssh-add -l was empty at first. Once you added the key, it worked fine. How to avoid running ssh-add every time macOS Keychain (recommended) ssh-add —apple-use-keychain ~/.ssh/ahmad.raza@org-name.co.in And in ~/.ssh/config: Host bitbucket.org HostName bitbucket.org User git IdentityFile ~/.ssh/ahmad.raza@org-name.co.in UseKeychain yes AddKeysToAgent yes Linux (persistent agent) Add this to ~/.bashrc or ~/.zshrc: eval ”$(ssh-agent -s)” ssh-add ~/.ssh/ahmad.raza@org-name.co.in That way, your key loads automatically on login and you won’t hit this issue again. 👉 Do you want me to give you the exact ~/.ssh/config setup so you’ll never have to ssh-add manually again on your Mac?