Como Instalar o MongoDB no Ubuntu: Guia Passo a Passo (Versão 8.0)

Se você já tentou instalar o MongoDB seguindo a documentação oficial e travou em algum passo sem saber o que deu errado, este guia é para você. Aqui cada comando tem uma explicação, cada passo tem uma verificação, e os erros mais comuns já estão mapeados com a solução.

Vamos instalar o MongoDB Community Edition 8.0 no Ubuntu — compatível com as versões 20.04 (Focal), 22.04 (Jammy) e 24.04 (Noble).

O que você vai precisar antes de começar

Ubuntu 20.04, 22.04 ou 24.04 (64-bit)
Mínimo de 2GB de RAM disponível
10GB de espaço em disco para dados e logs
Acesso sudo no terminal
Conexão com a internet

Por que MongoDB?

O MongoDB armazena dados em formato de documentos JSON-like, o que elimina a rigidez dos schemas relacionais. Isso o torna especialmente útil para:

Aplicações com estruturas de dados que mudam com frequência
Projetos de e-commerce, IoT, catálogos e APIs
Prototipagem rápida — a Community Edition é gratuita

Passo 1: Verifique a versão do seu Ubuntu

lsb_release -a

Anote a versão — você vai precisar dela no Passo 4.

Passo 2: Instale os pré-requisitos

sudo apt-get update
sudo apt-get install -y gnupg curl

Para confirmar:

curl --version
gpg --version

Passo 3: Importe a chave GPG do MongoDB

curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | \
  sudo gpg --dearmor -o /usr/share/keyrings/mongodb-server-8.0.gpg

Verifique:

ls /usr/share/keyrings/mongodb-server-8.0.gpg

Passo 4: Adicione o repositório oficial do MongoDB

Ubuntu 24.04 (Noble):

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | \
  sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

Ubuntu 22.04 (Jammy):

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" | \
  sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

Ubuntu 20.04 (Focal):

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/8.0 multiverse" | \
  sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

Passo 5: Atualize a lista de pacotes

sudo apt-get update

Se aparecer algum erro de “repository not signed”, volte ao Passo 3.

Passo 6: Instale o MongoDB

sudo apt-get install -y mongodb-org

Opcional — versão específica (8.0.6):

sudo apt-get install -y mongodb-org=8.0.6 mongodb-org-database=8.0.6 \
  mongodb-org-server=8.0.6 mongodb-mongosh mongodb-org-shell=8.0.6 \
  mongodb-org-mongos=8.0.6 mongodb-org-tools=8.0.6 \
  mongodb-org-database-tools-extra=8.0.6

Passo 7: Inicie o serviço MongoDB

ps --no-headers -o comm 1

Se `systemd`:

sudo systemctl start mongod
sudo systemctl status mongod
sudo systemctl enable mongod

Se `init`:

sudo service mongod start
sudo service mongod status

Passo 8: Verifique se a instalação funcionou

mongod --version
ps aux | grep -v grep | grep mongod
sudo cat /var/log/mongodb/mongod.log | grep "waiting for connections"

Passo 9: Conecte-se ao MongoDB

mongosh

db.version()
use test
db.testCollection.insertOne({ name: "Teste" })
db.testCollection.find()

Passo 10: Configurações pós-instalação

Arquivo de configuração

/etc/mongod.conf

Parâmetro	Padrão	O que faz
`bindIp`	`127.0.0.1`	Endereços aceitos
`port`	`27017`	Porta de escuta
`dbPath`	`/var/lib/mongodb`	Diretório de dados

Habilite autenticação

use admin
db.createUser({
  user: "admin",
  pwd: "sua_senha_segura",
  roles: [ { role: "root", db: "admin" } ]
})

Em mongod.conf:

security:
  authorization: "enabled"

sudo systemctl restart mongod
mongosh -u admin -p sua_senha_segura --authenticationDatabase admin

Permissões dos diretórios

sudo chown -R mongodb:mongodb /var/lib/mongodb
sudo chown -R mongodb:mongodb /var/log/mongodb

Solução de problemas mais comuns

Erro: “GPG key not found” → sudo apt-get clean && sudo apt-get update, repita Passo 3

Erro: “repository not found” → Verifique /etc/apt/sources.list.d/mongodb-org-8.0.list

Serviço não inicia → Verifique logs em /var/log/mongodb/mongod.log

Erro de conexão no mongosh → sudo systemctl status mongod e nc -zv 127.0.0.1 27017

Resumo dos comandos

Passo	Ação	Comando
1	Verificar versão	`lsb_release -a`
2	Pré-requisitos	`sudo apt-get install -y gnupg curl`
3	Chave GPG	`curl -fsSL ... \| sudo gpg --dearmor ...`
4	Repositório	`echo "deb ..." \| sudo tee ...`
5	Atualizar	`sudo apt-get update`
6	Instalar	`sudo apt-get install -y mongodb-org`
7	Iniciar	`sudo systemctl start mongod`
8	Verificar	`mongod --version`
9	Conectar	`mongosh`
10	Autenticação	`db.createUser(...)`

Desinstalação (se necessário)

sudo systemctl stop mongod
sudo apt-get purge mongodb-org*
sudo rm -r /var/log/mongodb
sudo rm -r /var/lib/mongodb
sudo rm /etc/apt/sources.list.d/mongodb-org-8.0.list

Referências

← Voltar ao Blog