DEV Community: Higor Morais

Guia de Configuração: Zsh, Oh My Zsh e Atuin

Higor Morais — Tue, 21 Apr 2026 12:25:38 +0000

Aqui está um tutorial completo sobre como instalar o Oh My Zsh (junto com os plugins mais populares) e configurar o Atuin para o histórico do shell.

No final deste guia, você encontrará um Makefile que automatiza essas instalações para que você possa replicar facilmente essa configuração em qualquer sistema baseado em Unix (Linux ou macOS).

1. Pré-requisitos

Certifique-se de ter o zsh, curl e git instalados no seu sistema.

No Ubuntu/Debian:

sudo apt update
sudo apt install zsh curl git

No macOS (via Homebrew):

brew install zsh curl git

Defina o Zsh como seu shell padrão:

chsh -s $(which zsh)

2. Instalação do Oh My Zsh

Execute o script oficial de instalação:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

3. Instalando Plugins do Zsh

(Nota: Como não consegui ler automaticamente seus plugins específicos do .zshrc, incluí os dois plugins da comunidade mais essenciais e populares. Você pode adicionar outros facilmente à lista!)

1. zsh-autosuggestions (Sugere comandos enquanto você digita com base no histórico)

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

2. zsh-syntax-highlighting (Destaca a sintaxe dos comandos enquanto são digitados)

git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

Configuração:
Abra seu arquivo ~/.zshrc e atualize o array plugins para incluí-los (junto com o git), assim:

plugins=(
    git
    zsh-autosuggestions
    zsh-syntax-highlighting
    # Adicione seus outros plugins aqui!
)

Em seguida, recarregue seu shell: source ~/.zshrc

4. Instalação e Configuração do Atuin

O Atuin substitui seu histórico de shell existente por um banco de dados SQLite, permitindo sincronização criptografada e recursos incríveis de pesquisa.

Instalação:

curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh

Configuração:
O Atuin deve se adicionar automaticamente ao seu ~/.zshrc. Se não o fizer, adicione esta linha no FINAL do seu ~/.zshrc:

eval "$(atuin init zsh)"

Sincronização e Configuração de Conta (Opcional, mas recomendado):
Se você quiser fazer backup e sincronizar seu histórico entre computadores:

# Registre uma conta
atuin register -u <USUARIO> -e <EMAIL>

# Ou se você já tem uma conta, faça login:
atuin login -u <USUARIO>

# Importe seu histórico existente
atuin import auto

# Sincronize
atuin sync

5. Configuração Automatizada via Makefile

Para facilitar as coisas em qualquer sistema baseado em Unix, crie um arquivo chamado Makefile e cole o conteúdo a seguir.

Este Makefile verifica as dependências, instala o Oh My Zsh, clona os plugins, instala o Atuin e fornece um comando para atualizar automaticamente o seu .zshrc.

# Makefile para configuração do Zsh, Oh My Zsh, Plugins e Atuin

.PHONY: all check-deps install-zsh install-oh-my-zsh install-plugins install-atuin configure-zshrc

all: check-deps install-oh-my-zsh install-plugins install-atuin configure-zshrc
    @echo "======================================================="
    @echo "Instalação concluída! Por favor, reinicie seu terminal ou execute:"
    @echo "exec zsh"
    @echo "======================================================="

check-deps:
    @echo "Verificando dependências..."
    @command -v git >/dev/null 2>&1 || { echo >&2 "git é necessário, mas não está instalado. Abortando."; exit 1; }
    @command -v curl >/dev/null 2>&1 || { echo >&2 "curl é necessário, mas não está instalado. Abortando."; exit 1; }
    @command -v zsh >/dev/null 2>&1 || { echo >&2 "zsh é necessário. Por favor, instale o Zsh primeiro."; exit 1; }

install-oh-my-zsh:
    @echo "Instalando Oh My Zsh..."
    @if [ ! -d "$$HOME/.oh-my-zsh" ]; then \
        RUNZSH=no sh -c "$$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"; \
    else \
        echo "Oh My Zsh já está instalado."; \
    fi

install-plugins:
    @echo "Instalando Plugins do Zsh..."
    @if [ ! -d "$${ZSH_CUSTOM:-$$HOME/.oh-my-zsh/custom}/plugins/zsh-autosuggestions" ]; then \
        git clone https://github.com/zsh-users/zsh-autosuggestions "$${ZSH_CUSTOM:-$$HOME/.oh-my-zsh/custom}/plugins/zsh-autosuggestions"; \
    else \
        echo "zsh-autosuggestions já está instalado."; \
    fi
    @if [ ! -d "$${ZSH_CUSTOM:-$$HOME/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting" ]; then \
        git clone https://github.com/zsh-users/zsh-syntax-highlighting.git "$${ZSH_CUSTOM:-$$HOME/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting"; \
    else \
        echo "zsh-syntax-highlighting já está instalado."; \
    fi

install-atuin:
    @echo "Instalando o Atuin..."
    @if ! command -v atuin >/dev/null 2>&1; then \
        curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh; \
    else \
        echo "Atuin já está instalado."; \
    fi

configure-zshrc:
    @echo "Configurando ~/.zshrc..."
    @if grep -q "plugins=(git)" $$HOME/.zshrc; then \
        sed -i.bak 's/plugins=(git)/plugins=(git zsh-autosuggestions zsh-syntax-highlighting)/' $$HOME/.zshrc; \
        echo "Plugins atualizados no ~/.zshrc"; \
    fi
    @if ! grep -q "atuin init zsh" $$HOME/.zshrc; then \
        echo 'eval "$$(atuin init zsh)"' >> $$HOME/.zshrc; \
        echo "Inicialização do Atuin adicionada ao ~/.zshrc"; \
    fi

Como usar o Makefile:

Salve o bloco de código acima como Makefile
Abra o seu terminal no diretório onde você o salvou.
Execute o comando: make ou make all

Ele configurará tudo perfeitamente para você!

Resgatando a Performance do Meu Macos com Docker Distribuído

Higor Morais — Mon, 13 Oct 2025 13:40:20 +0000

Trabalhar com Docker é essencial para o desenvolvimento moderno, mas, em máquinas com recursos limitados, a ferramenta pode se tornar um pesadelo. Recentemente, enfrentei o desafio de conciliar a praticidade dos containers com a performance sofrível do meu macbook.

Com pouco espaço em disco e o alto consumo de recursos gerado pelo docker desktop, o sistema operacional e outras ferramentas essenciais, como o cursor (que também demanda memória), frequentemente sofriam. O resultado era um dia a dia de trabalho marcado por lentidão e travamentos.

A solução? Mover o processamento. Decidi transformar uma pequena máquina que eu tinha parada em casa em um servidor docker dedicado, aliviando a carga do meu mac e recuperando a performance.

Adotei uma estratégia para gerenciar meus containers no servidor remoto (homeserver) com a mesma facilidade de um ambiente local, baseada em recursos nativos do sistema: contextos docker e chaves SSH configuradas.

Abaixo, detalho os caminhos que tomei para alcançar um acesso remoto rápido, seguro e eficiente, liberando os recursos do meu Mac para o que realmente importa.

Passo 1: A Solução de Performance – Contextos Docker para Alívio de Recursos

O primeiro passo foi abraçar a ferramenta nativa do Docker para alternar entre ambientes: Contextos Docker. Esta foi a escolha ideal, pois me permite gerenciar meus containers no servidor remoto (homeserver) com os mesmos comandos que uso localmente, mantendo a flexibilidade de voltar para o ambiente default (minha máquina) quando necessário, como em viagens.

Ao fazer isso, movi o pesado gerenciamento da virtual machine do docker desktop e o consumo de recursos dos containers para o servidor dedicado, deixando o mac livre.

Como configurar o Contexto Docker:

Gere as Chaves SSH (Conforme o Passo 2, abaixo).

Crie o Contexto Remoto:

docker context create homeserver --docker host=ssh://user@homeserver

Para usar o servidor remoto:

docker context use homeserver
# Agora, 'docker ps' mostra os containers do servidor

Para voltar à sua máquina local (e reverter o consumo de recursos):
```
docker context use default
```

Passo 2: O Fim das Senhas – Chaves SSH para Autenticação Rápida

Para garantir que a troca de contexto fosse instantânea — e para permitir que o Contexto Docker funcionasse sem interrupções —, a autenticação por senha precisava ser eliminada. A solução foi o uso de chaves SSH.

Após gerar meu par de chaves, eu copiei a chave pública para o servidor remoto, permitindo que a conexão fosse estabelecida instantaneamente:

Gerar o par de chaves (local):
```
ssh-keygen -t rsa -b 4096
```
Copiar a chave pública (para o servidor):
```
ssh-copy-id user@homeserver
```
Com as chaves configuradas, o Docker pode se conectar ao daemon remoto sem me pedir a senha, tornando a alternância de contexto imediata e fluida.

Passo 3: Acessando os Serviços Docker como "Localhost" com `~/.ssh/config`

Mudar o Docker para o servidor resolve o problema de performance, mas eu ainda precisava acessar os serviços (como um banco de dados ou um Localstack) de forma conveniente.

Para isso, configurei o arquivo ~/.ssh/config para automatizar a criação de túneis SSH (Port Forwarding), permitindo que eu acesse, por exemplo, o PostgreSQL rodando no servidor simplesmente digitando localhost:5432 no meu cliente local.

Minha configuração no arquivo ~/.ssh/config:

Host homeserver
    # O endereço IP ou DNS real do seu servidor (Substitua!)
    HostName [IP-DO-HOMESERVER] 

    # Usuário SSH na máquina remota
    User user

    # Porta SSH (padrão)
    Port 22 

    # 1. Túnel para a porta 5432 (Ex: PostgreSQL)
    # Porta local 5432 aponta para a porta 5432 no homeserver
    LocalForward 5432 localhost:5432 

    # 2. Túnel para a porta 4566 (Ex: Serviço AWS Localstack)
    # Porta local 4566 aponta para a porta 4566 no homeserver
    LocalForward 4566 localhost:4566 

    # Garante que a conexão não caia por inatividade
    ServerAliveInterval 60
    ServerAliveCountMax 5

    # Opcional: Não abre um terminal, apenas mantém o túnel ativo
    RequestTTY no

    # Opcional: Configuração para autenticação de host (em caso de IP estático)
    StrictHostKeyChecking no

Para ativar o túnel e acessar os serviços:

ssh -f -N homeserver

Conclusão

Ao combinar a conveniência dos Contextos Docker para o gerenciamento de containers e a segurança dos Túneis SSH configurados para o acesso aos serviços, consegui não apenas um ambiente de desenvolvimento mais saudável, mas também salvei meu tempo de vida evitando irritações desnecessárias com a falta de recursos da minha máquina.