Transforme seu Raspberry Pi em um Servidor de Desenvolvimento Completo (Debian 13 Trixie, ARM64)

 O Raspberry Pi evoluiu muito desde seus primeiros dias como uma placa para experimentos. Hoje, com o Debian 13 (Trixie) rodando em ARM64, ele pode funcionar como um servidor de desenvolvimento silencioso, eficiente e extremamente versátil.

Neste guia, você vai transformar seu Raspberry Pi em uma máquina de desenvolvimento completa, incluindo:

• Ferramentas essenciais para C/C++
• Stack Python moderno
• Docker Engine + Docker Compose (repositório oficial ARM64)
• pyenv para gerenciar múltiplas versões do Python
• Visual Studio Code oficial para ARM64

Seja para microserviços, automações, projetos de IA ou testes de CI, este setup deixa seu Raspberry Pi pronto para qualquer tarefa.

1. Atualize o Sistema Operacional

Antes de tudo, garanta que o sistema está atualizado:

sudo apt update
sudo apt full-upgrade -y

Manter o sistema limpo e atualizado evita conflitos de dependências mais tarde.

2. Instale o Conjunto Básico de Ferramentas de Desenvolvimento

Ferramentas para C/C++

sudo apt install -y \
    build-essential \
    cmake \
    ninja-build \
    gdb \
    git \
    pkg-config

Esses pacotes permitem compilar softwares nativos, depurar e trabalhar com projetos modernos baseados em CMake.

Stack de Desenvolvimento Python

sudo apt install -y \
    python3 \
    python3-dev \
    python3-pip \
    python3-venv \
    python3-setuptools \
    python3-wheel

Mesmo usando pyenv depois, o Python do sistema é útil para ferramentas e scripts auxiliares.

Utilitários Gerais

sudo apt install -y \
    curl \
    wget \
    unzip \
    zip \
    tree \
    htop \
    vim

Ferramentas essenciais para qualquer ambiente de desenvolvimento.

3. Instale Docker (Repositório Oficial ARM64)

O pacote docker.io do Debian é antigo e pode causar conflitos com o plugin oficial do Docker Compose. Por isso, usaremos o repositório oficial do Docker, que fornece binários ARM64 compatíveis com o Raspberry Pi.

Pré‑requisitos

sudo apt update
sudo apt install -y ca-certificates curl

Adicione a chave GPG do Docker

sudo install -m 0755 -d /etc/apt/keyrings

sudo curl -fsSL https://download.docker.com/linux/debian/gpg \
    -o /etc/apt/keyrings/docker.asc

sudo chmod a+r /etc/apt/keyrings/docker.asc

Adicione o repositório do Docker (Debian 13 Trixie)

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
  trixie stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Instale Docker Engine + Docker Compose

sudo apt update

sudo apt install -y \
    docker-ce \
    docker-ce-cli \
    containerd.io \
    docker-buildx-plugin \
    docker-compose-plugin

Ative o Docker e adicione seu usuário ao grupo

sudo systemctl enable --now docker
sudo usermod -aG docker "$USER"
newgrp docker

Verifique a instalação

docker --version
docker compose version
docker run --rm hello-world
docker info | grep -E 'Architecture|Server Version'

Você deve ver Architecture: aarch64, confirmando que o Docker instalou os binários corretos para ARM64.

4. Instale o pyenv (Gerenciador de Versões Python)

O pyenv permite instalar e alternar entre múltiplas versões do Python — essencial para desenvolvimento moderno.

Instale dependências de compilação

sudo apt update

sudo apt install -y \
    build-essential \
    curl \
    git \
    libssl-dev \
    zlib1g-dev \
    libbz2-dev \
    libreadline-dev \
    libsqlite3-dev \
    libncursesw5-dev \
    xz-utils \
    tk-dev \
    libxml2-dev \
    libxmlsec1-dev \
    libffi-dev \
    liblzma-dev

Instale o pyenv

curl https://pyenv.run | bash

Configure o pyenv no Bash

cat >> ~/.bashrc <<'EOF'

# pyenv
export PYENV_ROOT="$HOME/.pyenv"
[[ -d "$PYENV_ROOT/bin" ]] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init - bash)"
EOF

Recarregue o shell:

source ~/.bashrc

Verifique

pyenv --version
pyenv install --list

Exemplo: instalar Python 3.11

pyenv install 3.11

5. Instale o Visual Studio Code (ARM64 Oficial)

A Microsoft fornece um repositório oficial para ARM64 — perfeito para o Raspberry Pi.

Instale pré‑requisitos

sudo apt update
sudo apt install -y wget gpg

Adicione a chave GPG da Microsoft

wget -qO- https://packages.microsoft.com/keys/microsoft.asc \
    | sudo gpg --dearmor -o /usr/share/keyrings/microsoft.gpg

sudo chmod a+r /usr/share/keyrings/microsoft.gpg

Adicione o repositório do VS Code

sudo tee /etc/apt/sources.list.d/vscode.sources > /dev/null <<'EOF'
Types: deb
URIs: https://packages.microsoft.com/repos/code
Suites: stable
Components: main
Architectures: amd64,arm64,armhf
Signed-By: /usr/share/keyrings/microsoft.gpg
EOF

Instale o VS Code

sudo apt update
sudo apt install -y code

Verifique

code --version

Inicie:

code

Seu Raspberry Pi Agora é um Servidor de Desenvolvimento Completo

Com tudo instalado, seu Raspberry Pi está pronto para:

• Desenvolver projetos Python, C/C++ ou Rust
• Rodar microserviços em Docker
• Criar ambientes isolados com pyenv
• Usar VS Code localmente ou via SSH remoto
• Testar automações, agentes e workloads de IA
• Servir como um mini‑servidor de CI ou build