# Installazione di un'app sul tuo sito

Source: https://support.kapsulehost.com/it-it/apps-installing

L'installazione guidata delle app richiede tre passaggi: configura l'account amministratore e le impostazioni del sito, esamina cosa sta per accadere, quindi guarda l'installazione in esecuzione e raccogli i tuoi dati di accesso.

## Prima di Iniziare

Ti serve una cosa sola: un **sito web attivo** sul tuo account. La procedura guidata si installa su un sito che già possiedi, non ne crea uno nuovo. Se non ne hai nessuno, la procedura guidata te lo dice e ti collega a una pagina per crearne uno. Vedi [Creazione del Tuo Primo Sito Web](https://support.kapsulehost.com/it-it/creating-your-first-website).

Ti serve anche il permesso **apps:write**, che hanno i proprietari dell'account e gli amministratori.

> **Warning:** Effettua un backup prima di installare su un sito che contiene già contenuti. La procedura guidata ha una rete di sicurezza per un sito che già possiede un'app, descritta di seguito, ma un punto di ripristino manuale creato deliberatamente vale sempre più di uno creato automaticamente. Vedi [Creazione di un Backup](https://support.kapsulehost.com/it-it/taking-a-backup).

## Accesso alla Procedura Guidata

1. Fai clic su **Apps** nella barra laterale di KPanel.
2. Fai clic sull'app che desideri.
3. Fai clic su **Installa [app]** nel pannello sulla destra.

L'indirizzo diretto è `/apps/<app-slug>/install`.

![La procedura guidata di installazione dell'app in KPanel, con il pulsante Installa nel pannello sulla destra](https://support.kapsulehost.com/help/screenshots/apps-installing.1f6e023d.webp)

## Passaggio 1: Configurazione

La procedura guidata mostra l'app, quindi quattro gruppi di campi. Un avviso **Aggiornamento del piano consigliato** appare in alto se l'app suggerisce un livello di piano superiore a quello su cui sei: è un consiglio, e l'installazione procede comunque.

### Posizione

**Installa sul sito.** Scegli tra i tuoi siti attivi. Questo è il luogo in cui l'app risiederà.

### Account Amministratore

- **Nome utente amministratore.** Il valore predefinito è `admin`. Questo è il nome utente con cui accederai, e puoi aggiungere altri utenti in seguito.
- **Password amministratore.** Una password di 16 caratteri forte viene generata per te nel momento in cui la pagina si carica. **Mostra** la rivela e **Genera** ne crea una nuova. Puoi anche digitare la tua; deve essere di almeno 8 caratteri.
- **Email amministratore.** Facoltativa. Utilizzata per l'accesso e la reimpostazione della password. Se lasciata vuota, viene utilizzata la tua email dell'account.

> **Important:** Salva la password amministratore prima di uscire dalla procedura guidata. Viene mostrata nella schermata di revisione e di nuovo nella schermata di successo, e poi scompare. KapsuleHost non conserva una copia che puoi recuperare in seguito, quindi perderla significa reimpostare la password attraverso l'app stessa.

### Impostazioni del Sito

- **Nome del sito**, dove l'app lo richiede.
- **Lingua.** La lingua in cui l'app è configurata, scelta tra sedici opzioni tra cui English (US), English (UK), Te Reo Māori, e i principali linguaggi europei e asiatici. Questo imposta la lingua del contenuto dell'app, non quella di KPanel.

### Database

Mostrato solo per le app che ne hanno bisogno. La procedura guidata suggerisce un nome di database derivato dal tuo dominio. Solo lettere e numeri, niente trattini bassi o trattini: il campo lo applica mentre digiti. Modificalo se vuoi.

Le app che richiedono un database lo hanno fornito automaticamente come parte dell'installazione.

Alcune app aggiungono campi extra propri sotto questo, definiti dall'app stessa, con testo di aiuto dove applicabile. I campi obbligatori sono contrassegnati con un asterisco, e **Continua** rimane disabilitato fino a quando tutti non sono compilati.

In fondo la procedura guidata mostra il riepilogo delle risorse per questa app: il tempo di installazione previsto, la RAM minima e se viene aggiunto un database.

Fai clic su **Continua**.

## Passaggio 2: Revisione e Conferma

La schermata di revisione reitera le decisioni in un unico elenco: app, sito web, nome del sito, nome utente amministratore, password amministratore (con un interruttore mostra o nascondi), email amministratore, lingua e nome del database. Il sottotitolo lo dice chiaramente: **nulla è installato fino a quando non confermi.**

- **Modifica** torna indietro per cambiare qualcosa.
- **Conferma e installa** avvia il lavoro.

> **Tip:** Utilizza la schermata di revisione per il controllo più importante: la riga **Sito Web**. L'installazione sul sito sbagliato è l'errore di installazione più comune, ed è quello che la protezione da sovrascrittura sottostante esiste per catturare.

## Passaggio 3: Installazione

La procedura guidata passa a una visualizzazione del progresso. Vedrai, in ordine:

- **In coda: in attesa di lavoro.** Il tuo lavoro è in coda e inizierà a breve.
- **Installazione di [app]**, con secondi trascorsi rispetto al tempo di installazione tipico e una barra di progresso.

Lascia la pagina aperta. L'installazione continua in background se navighi via, ma perdi la visualizzazione dal vivo e il riepilogo delle credenziali alla fine.

Se l'installazione incontra un problema, riprova automaticamente, mostrando **Nuovo tentativo di installazione** con il numero del tentativo. Se si estende ben oltre il tempo previsto, appare una nota che offre di continuare ad aspettare o cancellare.

### Cancellazione

**Annulla installazione** interrompe il lavoro. La schermata del risultato lo conferma: *L'installazione è stata interrotta. Nulla è stato modificato sul tuo sito.*

## Quando il Sito Contiene Già un'App

Se la directory del sito di destinazione contiene già un sito, l'installazione si arresta con un avviso che nomina ciò che ha trovato:

> Questa directory contiene già [app]. L'installazione di [nuova app] lo SOVRASCRIVERÀ e non può essere annullata. Un backup completo del tuo sito attuale verrà effettuato prima in modo che tu possa ripristinarlo.

Due scelte: annulla, o **Backup e sovrascrittura**. Se acconsenti, il lavoro effettua un backup completo del sito esistente prima di scrivere qualsiasi cosa, quindi c'è un punto di ripristino.

> **Important:** Questo è il punto di non ritorno nella procedura guidata. La sovrascrittura sostituisce i file del sito esistente. Il backup automatico significa che è recuperabile, non che è reversibile con un clic. Se non sei sicuro che il sito sia eliminabile, annulla e installa su un sito diverso.

## App che il Nostro Team Installa Manualmente

Alcune app non hanno un programma di installazione automatico provato. Per queste la procedura guidata salta completamente la barra di progresso e mostra invece una conferma calorosa:

> Stiamo configurando [app] per te. Questa app ha bisogno di una configurazione pratica, quindi il nostro team la installa sul tuo sito per te dopo che hai ordinato. Ti invieremo un'email nel momento in cui è attivo; non c'è nient'altro che tu debba fare.

Nulla ha avuto esito negativo e nulla è in sospeso su di te. Le app sono gratuite, quindi non c'è alcun addebito in entrambi i casi.

## Passaggio 4: Sei Online

Al termine, la procedura guidata mostra **[app] è online**, un collegamento al tuo dominio e il riepilogo delle credenziali:

- Nome utente amministratore
- Password amministratore, con mostra o nascondi
- Email amministratore
- Titolo del sito

Mostra anche il **log di installazione**, riga per riga, con ogni passaggio contrassegnato come riuscito, non riuscito o saltato. Quel log è degno di uno sguardo anche durante un'installazione pulita: ti dice esattamente cosa è stato configurato.

Due pulsanti completano il flusso: **Apri [app]** va direttamente all'app, e **Torna al Catalogo** ritorna alla pagina del catalogo.

## Se Fallisce

**Installazione non riuscita.** La schermata del risultato mostra cosa è successo e afferma la parte importante: *Qualsiasi modifica parziale è stata annullata. Il tuo sito è pulito.* Due azioni sono offerte, **Riprova** e **Contatta il Supporto**.

Le cause comuni e cosa fare:

- **Limiti di risorse.** Se la RAM minima dell'app è superiore a quella che il tuo piano gli assegna, l'installazione può fallire a metà percorso. Controlla la figura **RAM Min** nella pagina dell'app. Vedi [Aggiornamento del Tuo Piano](https://support.kapsulehost.com/it-it/upgrading-your-plan).
- **Un campo rifiutato.** La procedura guidata rifiuta l'input contenente caratteri non sicuri per la shell prima che il lavoro sia anche messo in coda, e nomina il campo. Semplifica il valore: un nome utente semplice, una password generata, un nome di database con lettere e numeri.
- **Il sito non è attivo.** Solo i siti con stato **ATTIVO** appaiono nel menu a discesa del sito. Un sito ancora in provisioning non sarà elencato.

**L'installazione è riuscita ma il sito mostra un errore.** Controlla il log di installazione per un passaggio non riuscito, quindi controlla la documentazione dell'app stessa per la configurazione post-installazione. Le app della comunità in particolare spesso hanno bisogno che un wizard di configurazione finale sia eseguito nel browser. Vedi [Sito Web Non Caricato](https://support.kapsulehost.com/it-it/website-not-loading).

**Hai perso la password amministratore.** Usa la reimpostazione della password dell'app con l'email amministratore che hai impostato. Per WordPress nello specifico, vedi [Reimpostazione di una Password di WordPress](https://support.kapsulehost.com/it-it/wordpress-reset-password).

**L'installazione è bloccata su In Coda.** La coda dei lavori è occupata. Inizierà. Se è ancora in coda molto tempo dopo il tempo di installazione previsto, annullalo e riprova, quindi [apri un ticket di supporto](https://support.kapsulehost.com/it-it/opening-a-support-ticket) se si ripete.

## Letture Correlate

- [Il Catalogo delle App](https://support.kapsulehost.com/it-it/apps-overview)
- [Installazione di WordPress](https://support.kapsulehost.com/it-it/installing-wordpress)
- [Esecuzione di un backup](https://support.kapsulehost.com/it-it/taking-a-backup)
- [Il Mio Sito Web Non Si Carica: Lista di Controllo Diagnostica](https://support.kapsulehost.com/it-it/website-not-loading)