# Portainer per Docker: come installarlo Portainer rappresenta un **modo conveniente per gestire ambienti container distribuiti**. Il software viene installato come un container Docker e può quindi essere eseguito praticamente ovunque. In questo articolo vi mostriamo la routine di installazione da seguire e vi forniamo alcuni consigli utili. --- ### Consiglio Utilizzate Portainer per gestire i vostri cluster Kubernetes su un [VPS](https://www.ionos.it/server/vps "VPS Hosting: server virtuali per Windows/Linux - IONOS") di IONOS. --- ## Cos’è Portainer? [Portainer](https://www.portainer.io/ "Portainer: interfaccia per la gestione di container per Kubernetes, Docker, Swarm") è già stato introdotto come un’**[alternativa flessibile a OpenShift](https://www.ionos.it/digitalguide/server/know-how/alternative-a-openshift/ "Alternative a OpenShift")** nel nostro articolo al riguardo. A differenza di OpenShift, Portainer non è una distribuzione Kubernetes a sé stante. Il software open source, infatti, centralizza e unifica la gestione delle infrastrutture cluster esistenti attraverso l’utilizzo di un’interfaccia grafica basata sul web. Oltre alla “Community Edition” (CE) gratuita, è anche disponibile una versione a pagamento completa di supporto aziendale. L’obiettivo principale di Portainer è quello di unificare la **gestione delle implementazioni Kubernetes esistenti**. Portainer consente ai team DevOps di configurare, proteggere e gestire centralmente gli ambienti multi-cluster. Inoltre, anche i team di sviluppo possono trarre vantaggio dal software, che facilita anche la distribuzione, la gestione e la risoluzione dei problemi delle applicazioni. Convenientemente, Portainer non è solo adatto come interfaccia di gestione per [Kubernetes](https://www.ionos.it/digitalguide/server/know-how/che-cose-kubernetes/ "Che cos'è Kubernetes?") ma consente anche la **gestione di cluster o container** basata su Docker e [Docker Swarm](https://www.ionos.it/digitalguide/server/know-how/orchestrazione-di-docker-con-swarm-e-compose/ "Orchestrazione di Docker con Swarm e Compose"). Il software può essere installato praticamente ovunque e può essere eseguito su ambienti cloud e dispositivi edge così come sulla vostra infrastruttura informatica on-premises, cioè in loco. Nei paragrafi seguenti vi mostriamo come installare Portainer per Docker. --- ### Consiglio Seguite il nostro [tutorial su Docker](https://www.ionos.it/digitalguide/server/configurazione/tutorial-di-docker/ "Tutorial di Docker") per impostare Docker sul vostro sistema locale. --- ## Come installare Portainer per Docker? Per capire come installare Portainer, bisogna comprenderne l’architettura di base, composta da due componenti che vengono installati individualmente come [container Docker](https://www.ionos.it/digitalguide/server/know-how/container-docker/ "Container Docker"): 1. Un **server Portainer** come istanza centralizzata. Include un database e richiede un livello di archiviazione per la memorizzazione dei dati. Il server Portainer gestisce l’[ambiente Docker](https://www.ionos.it/digitalguide/server/know-how/cose-docker/) locale e, se necessario, altri ambienti collegati tramite agenti. 2. **Più agenti Portainer**, se necessario, per gestire ulteriori ambienti. Un’istanza dell’agente Portainer viene eseguita su ogni nodo del cluster da gestire. Sia il server Portainer che gli agenti vengono eseguiti **come contenitori sull’infrastruttura esistente**. Ciò perché gli agenti comunicano con il server e affinché questa interazione funzioni, il server e gli agenti devono essere sulla stessa rete. Inoltre, vi sono anche degli agenti edge che vengono eseguiti come istanze su dispositivi remoti. La particolarità di questi agenti è che comunicano con il server attraverso i confini della rete tramite un tunnel TLS criptato. Di seguito vi mostreremo **l’installazione del server e dell’agente Portainer per Docker** (standalone) in riferimento alla Community Edition (CE) versione 2.9.3 e utilizzando Docker Desktop come base. Quest’ultimo è eseguibile solo su Windows e macOS, sebbene l’installazione su Linux sia quasi identica. Fate attenzione che per l’uso produttivo, i server e gli agenti vengono eseguiti su macchine diverse. ### Installare il server Portainer per Docker Desktop Dato che il **server Portainer è disponibile come immagine Docker**, il processo di installazione è abbastanza semplice. Di seguito vi mostriamo come fare in pochi semplici passaggi. 1. Per prima cosa, bisognerà creare un **volume Docker** che contenga i dati gestiti dal server Portainer: ```none docker volume create Portainer_data ``` 2. **Successivamente, dovrete verificare** che il volume Docker chiamato ‘Portainer\_data’ esista: ```none docker volume ls ``` 3. A questo punto si potrà passare **all’installazione del server Portainer vero e proprio**. Avviate il server come container Docker a partire dall’immagine Docker corrispondente. A meno che l’immagine non sia locale, verrà scaricata automaticamente: ```none docker run -d -p 8000:8000 -p 9443:9443 --name Portainer \ --restart=always \ -v /var/run/docker.sock:/var/run/docker.sock \ -v Portainer_data:/data \ cr.Portainer.io/Portainer/Portainer-ce:2.9.3 ``` 4. **Successivamente, dovrete controllare** che il container Docker chiamato ‘Portainer’ sia in esecuzione: ```none docker ps ``` ### Configurare il server Portainer per Docker Se il server Portainer è stato installato correttamente, **l’interfaccia web di Portainer sarà accessibile sull’host locale alla porta specificata**. In questo caso, è la porta 9443. Arrivati a questo punto dovrete configurare il server Portainer. 1. Per prima cosa, è necessario **richiamare l’interfaccia web** di Portainer nel browser: *https://localhost:9443*. 2. Quando si usa Portainer per la prima volta, bisognerà creare un **utente admin** prima di impostare Portainer. [![Immagine: Schermata mostrante il primo accesso all’interfaccia web di Portainer](https://www.ionos.it/digitalguide/fileadmin/_processed_/5/e/csm_startbildschirm-portainer-weboberflaeche_8a3921571d.webp "Schermata mostrante il primo accesso all’interfaccia web di Portainer")](https://www.ionos.it/digitalguide/fileadmin/DigitalGuide/Screenshots_2022/startbildschirm-portainer-weboberflaeche.png) Accedendo all’interfaccia web di Portainer per la prima volta, vi verrà richiesto di creare un utente admin. [![Immagine: Schermata di Portainer mostrante i dettagli utente admin inseriti](https://www.ionos.it/digitalguide/fileadmin/_processed_/f/3/csm_startbildschirm-portainer-admin-nutzerdaten_b32a303322.webp "Schermata di Portainer mostrante i dettagli utente admin inseriti")](https://www.ionos.it/digitalguide/fileadmin/DigitalGuide/Screenshots_2022/startbildschirm-portainer-admin-nutzerdaten.png) Impostate nome utente e password per l’utente admin di Portainer. Per ragioni di sicurezza, abbiamo evitato il nome predefinito “admin” usando invece “portadmin” [![Immagine: Procedura guidata di configurazione rapida dell’interfaccia web di Portainer](https://www.ionos.it/digitalguide/fileadmin/_processed_/7/8/csm_quick-setup-wizard-portainer_da088bc42c.webp "Procedura guidata di configurazione rapida dell’interfaccia web di Portainer")](https://www.ionos.it/digitalguide/fileadmin/DigitalGuide/Screenshots_2022/quick-setup-wizard-portainer.png) Dopo aver effettuato il login come utente admin, arriverete alla procedura guidata di configurazione rapida dell’interfaccia web di Portainer. Oltre all’ambiente Docker locale, possono essere aggiunti degli ambienti remoti. [![Immagine: Schermata iniziale dell’interfaccia web di Portainer](https://www.ionos.it/digitalguide/fileadmin/_processed_/7/4/csm_home-bildschirm-portainer-weboberflaeche_e4a4f40178.webp "Schermata iniziale dell’interfaccia web di Portainer")](https://www.ionos.it/digitalguide/fileadmin/DigitalGuide/Screenshots_2022/home-bildschirm-portainer-weboberflaeche.png) Dopo aver fatto clic su “Get Started”, arriverete alla schermata iniziale dell’interfaccia web di Portainer. Qui vi verranno mostrati gli ambienti Docker attualmente gestiti da Portainer. [![Immagine: Schermata iniziale dell’interfaccia web di Portainer](https://www.ionos.it/digitalguide/fileadmin/_processed_/9/9/csm_dashboard-portainer-weboberflaeche_1b59ef741e.webp "Schermata iniziale dell’interfaccia web di Portainer")](https://www.ionos.it/digitalguide/fileadmin/DigitalGuide/Screenshots_2022/dashboard-portainer-weboberflaeche.png) Dopo aver fatto clic sull’ambiente Docker locale, vi ritroverete sulla schermata iniziale di Portainer. In questa sezione vengono mostrate le risorse Docker gestite. Come impostazione predefinita, l’installazione di Portainer utilizza un **certificato SSL auto firmato** per proteggere l’interfaccia web tramite HTTPS. Quando si effettua l’accesso, è probabile visualizzare un messaggio di avviso a seconda del browser e del sistema operativo utilizzati, che può essere aggirato in pochi clic, come mostrato nelle schermate seguenti. ### Aggiornare il server Portainer per Docker Desktop Il processo di aggiornamento del server Portainer è **strettamente legato alla routine di installazione**. Pertanto, anche in questo caso ve ne mostriamo i passaggi: 1. Per prima cosa, bisognerà **fermare il container in esecuzione** del server Portainer: ```none docker stop Portainer ``` 2. Successivamente, dovrete **rimuovere il container**: ```none docker rm Portainer ``` 3. In preparazione per l’aggiornamento, **scaricate l’ultima immagine del server Portainer**: ```none docker pull cr.Portainer.io/Portainer/Portainer-ce:2.9.3 ``` 4. Per **eseguire l’aggiornamento**, riavviate il container del server Portainer dall’immagine corrente: ```none docker run -d -p 8000:8000 -p 9000:9000 -p 9443:9443 \ --name=Portainer --restart=always \ -v /var/run/docker.sock:/var/run/docker.sock \ -v Portainer_data:/data \ cr.Portainer.io/Portainer/Portainer-ce:2.9.3 ``` ### Installare l’agente Portainer per Docker L’agente Portainer non è necessario per eseguire un’installazione locale su Docker. Tuttavia, se si desidera **gestire più ambienti in modo centralizzato**, è possibile installare l’agente su ogni macchina da collegare. Dato che l’agente Portainer è disponibile come container Docker, il processo di installazione è semplice. Tutto quello che dovete fare è eseguire il seguente comando sul sistema di destinazione: ```none docker run -d -p 9001:9001 --name Portainer_agent \ --restart=always \ -v /var/run/docker.sock:/var/run/docker.sock \ -v /var/lib/docker/volumes:/var/lib/docker/volumes \ cr.Portainer.io/Portainer/agent:2.9.3 ``` This is a markdown version of: [https://www.ionos.it/digitalguide/server/configurazione/come-installare-portainer-per-docker/](https://www.ionos.it/digitalguide/server/configurazione/come-installare-portainer-per-docker/) for AI/LLM consumption.