MacBook Air: Initial Hugo & Obsidian Setup#

1. Initial Software Installation.#

Open Terminal and run:

Install Hugo, & Git#

brew install hugo git

2. Pull Your Website Repository#

Ensure your SSH keys are added to the Mac, then clone directly into the target directory:

mkdir Obsidian
cd /Users/marc/Obsidian
git clone git@github.com:marcoue/Homelab.git
cd Homelab

3. Obsidian App Setup#

1. Launch Obsidian.
2. Select “Open folder as vault”.
3. Navigate to and select /Users/marc/Obsidian/Homelab.
4. All plugins (Git, numbering) and CSS will load automatically.

4. Obsidian Git Configuration (CRITICAL FOR SYNC)#

Manual Settings#

• Auto intervals: All set to 0
• Status bar display: Full (Ensures the numbers appear)
• Show status bar: ON (Displays the 0-0 sync numbers)
• Push on commit-and-sync: ON (Ensures work goes to GitHub)
• Pull on commit-and-sync: ON
• On Conflict: Manual

Hotkeys#

• Git: Commit-and-sync: Cmd + S
• Git: Pull: Cmd + Shift + S

5. Run Hugo website locally#

On MacStudio#

hugo server --bind 0.0.0.0 --baseURL http://10.1.2.4 --buildDrafts --disableFastRender --ignoreCache --noHTTPCache --gc -p 1313

On MacBook Air#

hugo server --bind 0.0.0.0 --baseURL http://10.1.2.5 --buildDrafts --disableFastRender --ignoreCache --noHTTPCache --gc -p 1313