Come installare MongoDB su Ubuntu: guida passo passo per principianti

Quindi sei pronto a sperimentare con MongoDB su Linux e hai scelto Ubuntu come distribuzione con cui lavorare. Ottima scelta: ti aspetta un’esperienza piuttosto semplice che ti permetterà di usare MongoDB in pochissimo tempo!

In questo tutorial, vedremo come installare MongoDB tramite l’Ubuntu Package Manager e faremo alcuni piccoli miglioramenti alla qualità della vita che renderanno la tua installazione più sicura rispetto al resto del mondo. Puoi anche dare un’occhiata alla guida video.

Anche se esploreremo l’installazione nativa, se preferisci usare Docker su Ubuntu per lavorare con MongoDB, dai un’occhiata al mio precedente tutorial, eseguire MongoDB in Docker. 

Prerequisiti

Per seguire con successo questo tutorial, dovrai utilizzare una versione moderna di Ubuntu. Io sto usando Ubuntu 25.04 Desktop Edition con CPU ARM, ma non dovresti avere problemi con altre architetture CPU o con Ubuntu Server Edition. 

Sebbene gli strumenti per lavorare con MongoDB siano piuttosto flessibili, per questo esempio, la MongoDB Shell sarà lo strumento principale usato per interagire con MongoDB.

Installare MongoDB Community Edition su Ubuntu con il gestore pacchetti

Dato che Ubuntu è una distribuzione Linux estremamente popolare, l’installazione di MongoDB è piuttosto lineare, come ti aspetteresti per altri pacchetti. Il processo prevede l’aggiunta di MongoDB come sorgente software al nostro gestore pacchetti, l’installazione del pacchetto e poi l’esecuzione del pacchetto installato.

Iniziamo importando la chiave GPG per MongoDB. Dalla riga di comando, esegui quanto segue:

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

A seconda della versione principale di MongoDB che desideri usare, le informazioni sulla versione in questo comando e nei comandi successivi potrebbero dover cambiare. In questo esempio useremo MongoDB 8.X.

Con la chiave GPG importata, possiamo procedere a creare il file dell’elenco dei pacchetti. Esegui il seguente comando:

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

Per chiarezza, sì, sto usando Ubuntu 25.04 (Plucky) e sì, l’elenco pacchetti qui sopra fa riferimento a MongoDB 24.04 (Noble). Per me ha funzionato, ma fai attenzione man mano che le versioni diventano significativamente diverse. Altrimenti potresti ottenere risultati imprevisti.

A questo punto, possiamo aggiornare il gestore pacchetti sul nostro computer:

sudo apt-get update

Per installare MongoDB, esegui il seguente comando:

sudo apt-get install -y mongodb-org

Il comando sopra installerà l’ultima versione di MongoDB, ma se ti serve una versione specifica, puoi includere le informazioni sulla versione nel comando, ad esempio mongodb-org=8.0.11.

A questo punto MongoDB dovrebbe essere installato sul computer. Tuttavia, potrebbe non essere in esecuzione al termine dell’installazione. Per avviare MongoDB su Ubuntu, esegui il seguente comando:

sudo systemctl start mongod

Puoi verificare che MongoDB funzioni correttamente collegandoti dalla MongoDB Shell, da MongoDB Compass o con strumenti simili. 

Nel caso della MongoDB Shell, puoi eseguire il seguente comando:

mongosh "mongodb://localhost:27017"

Ovviamente, il comando sopra presume che tu stia tentando di connetterti all’istanza MongoDB dallo stesso computer.

Se MongoDB avesse bisogno di essere arrestato, riavviato o simili, puoi usare i vari comandi systemctl comuni su Ubuntu.

Aggiungere sicurezza di base all’istanza MongoDB su Ubuntu

Per impostazione predefinita, l’autenticazione è disabilitata nelle nuove installazioni di MongoDB. Potrebbe andare bene a seconda del tuo caso d’uso, ma di solito è una buona idea richiedere almeno autenticazione e autorizzazione. 

Ovviamente, probabilmente vorrai esplorare anche altre best practice di hardening, come regole del firewall e simili, ma per lo scopo di questo tutorial, mettere in sicurezza la tua installazione di MongoDB su Ubuntu con un nome utente e una password è un buon punto di partenza.

Su Ubuntu, esegui il seguente comando:

sudo vi /etc/mongod.conf

Se preferisci usare nano o un altro strumento per modificare questo file, va benissimo.

Vai alla riga #security e modificala come segue:

security:
	authorization: "enabled"

Dopo aver salvato il file, riavvia l’istanza MongoDB eseguendo quanto segue:

sudo systemctl restart mongod

Non abbiamo ancora finito. Abbiamo solo attivato l’autenticazione, ma dobbiamo creare il nostro utente amministrativo.

Se stai usando la MongoDB Shell, esegui quanto segue:

use admin;

db.createUser({
	"user": "nraboy",
	"pwd": "mongodb",
	"roles": [
		{
			"role": "userAdminAnyDatabase",
			"db": "admin"
		}
	]
});

Probabilmente vorrai cambiare user e pwd con qualcosa di più sensato e sicuro, ma è solo un esempio.

Ora, quando vuoi connetterti a MongoDB usando la MongoDB Shell, useresti un comando come questo:

mongosh --host localhost --port 27017 -u nraboy -p --authenticationDatabase admin

L’esperienza sarà leggermente diversa a seconda dello strumento che utilizzi, ma puoi farti un’idea generale dalle informazioni che stiamo fornendo.

Conclusione

Hai appena visto come distribuire MongoDB su un host Linux—in particolare, Ubuntu. Il bello di MongoDB è che è piuttosto semplice da installare ed eseguire ovunque e su ogni tipo di hardware. 

Se MongoDB Atlas non è un’opzione e devi esplorare qualcosa di diverso da Ubuntu, potrebbe valere la pena consultare il mio altro tutorial che mostra una distribuzione in container con Docker. Tuttavia, se sei pronto a passare allo step successivo, considera il mio tutorial precedente su come creare un database in MongoDB.

Se lavori con Python e ti piace un approccio strutturato all’apprendimento, dai un’occhiata al corso Introduzione a MongoDB in Python.