Como instalar o Jekyll no Mac (do zero)

Presumindo que o Mac não tem nada instalado — nem Homebrew, nem Ruby atualizado. A documentação oficial do Jekyll recomenda hoje usar o chruby em vez do rbenv, por ser mais simples e dar menos dor de cabeça.

1. Instalar o Homebrew

Abra o Terminal e rode (ref):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Siga as instruções que aparecerem no final (geralmente pede para rodar 2 comandos para adicionar o Homebrew ao PATH — copie e cole exatamente o que ele mostrar).

Confirme que funcionou:

brew --version

2. Por que não usar o Ruby que já vem no Mac

O macOS vem com um Ruby pré-instalado, mas não é recomendado usá-lo para instalar o Jekyll — o certo é instalar uma versão separada e mais nova do Ruby usando um gerenciador de versões, e a recomendação oficial é o chruby.

3. Instalar Ruby + chruby via Homebrew

brew install chruby ruby-install
ruby-install ruby

Isso baixa e compila a versão estável mais recente do Ruby (pode demorar uns minutos).

4. Configurar o shell para usar o chruby

Se você usa zsh (padrão no Mac desde 2019):

echo "source $(brew --prefix)/opt/chruby/share/chruby/chruby.sh" >> ~/.zshrc
echo "source $(brew --prefix)/opt/chruby/share/chruby/auto.sh" >> ~/.zshrc

Feche e abra o Terminal de novo (ou rode source ~/.zshrc).

5. Selecionar a versão do Ruby instalada

Veja qual versão foi instalada:

chruby

Vai aparecer algo como ruby-3.4.x. Ative essa versão para a sua sessão atual e defina como padrão:

chruby ruby-3.4
echo "chruby ruby-3.4" >> ~/.zshrc

Confirme:

ruby -v

Não deve mostrar mais o Ruby “de sistema” (aquele antigo, tipo 2.6.x).

6. Instalar Bundler e Jekyll

gem install bundler jekyll

Confirme:

jekyll -v

7. Criar seu primeiro site (opcional, para testar)

jekyll new meu-site
cd meu-site
bundle exec jekyll serve

Abra http://localhost:4000 no navegador.


Nota: se em algum passo der erro de OpenSSL (comum em Macs mais novos com temas remotos), é um problema conhecido com correção simples — é só perguntar.