Questa guida fornisce istruzioni passo-passo per installare HarborDB sul tuo dispositivo macOS.

Metodi di Installazione

Mac App Store (Consigliato)

Il modo più semplice per installare HarborDB è attraverso l'ufficiale Mac App Store:

Apri il Mac App Store sul tuo dispositivo macOS
Cerca "HarborDB" nella barra di ricerca
Clicca "Ottieni" o il pulsante del prezzo ($19.99) per acquistare e scaricare
Attendi l'installazione - L'app verrà scaricata e installata automaticamente
Avvia HarborDB dalla cartella Applicazioni, Launchpad o Spotlight

Vantaggi dell'installazione tramite Mac App Store:

Aggiornamenti automatici
Distribuzione verificata e sicura
Installazione e rimozione facili
Supporto per Condivisione Familiare

Download Diretto (Alternativa)

Per distribuzioni aziendali o scopi di test, puoi scaricare HarborDB direttamente:

Visita la nostra pagina di download su harbordb.com/download
Scarica il file .dmg più recente
Apri il file .dmg facendo doppio clic
Trascina HarborDB nella cartella Applicazioni
Espelli l'immagine disco dopo la copia

Nota sulla Sicurezza: Quando scarichi direttamente, assicurati di verificare l'autenticità del download utilizzando i checksum forniti.

Requisiti di Sistema

Prima di installare, verifica che il tuo sistema soddisfi questi requisiti:

Requisiti Minimi

macOS: 12.0 (Monterey) o successivo
Processore: Intel Core i5 (8ª generazione) o Apple Silicon (M1)
Memoria: 8 GB RAM
Archiviazione: 200 MB spazio disponibile
Display: Risoluzione 1280 × 800

Requisiti Consigliati

macOS: 13.0 (Ventura) o successivo
Processore: Apple Silicon (M2 o più recente)
Memoria: 16 GB RAM o più
Archiviazione: 500 MB spazio disponibile (per cache ed esportazioni)
Display: Risoluzione 1920 × 1080 o superiore

Requisiti del Server PostgreSQL

PostgreSQL: Versione 9.6 o successiva (12+ consigliato)
Rete: Connettività TCP/IP al server PostgreSQL
Permessi: L'utente deve avere permessi di connessione e query

Primo Avvio

Dopo l'installazione, avvia HarborDB per la prima volta:

Trova HarborDB nella cartella Applicazioni o usa Spotlight (⌘ + Spazio, digita "HarborDB")
Fai doppio clic per avviare - Potrebbe essere necessario concedere il permesso per eseguire l'app (solo prima volta)
Rivedi i permessi di sistema:
- Accessibilità: Richiesto per scorciatoie da tastiera e miglioramenti UI (opzionale)
- Rete: Richiesto per connessioni database
- Keychain: Richiesto per l'archiviazione sicura delle password

Avvisi Gatekeeper (Download Diretto)

Se hai scaricato HarborDB direttamente, potresti vedere un avviso di sicurezza:

"HarborDB" non può essere aperto perché lo sviluppatore non può essere verificato.

Per risolvere questo:

Vai su Preferenze di Sistema → Sicurezza e Privacy
Clicca "Apri comunque" accanto all'avviso HarborDB
Conferma di voler aprire l'applicazione

Passaggi Post-Installazione

1. Verifica Installazione

Controlla che HarborDB appaia nella cartella Applicazioni
Verifica che l'app si avvii senza errori
Controlla il menu Informazioni (HarborDB → Informazioni su HarborDB) per informazioni sulla versione

2. Controlla Aggiornamenti

Mac App Store: Gli aggiornamenti sono automatici, ma puoi controllare manualmente nella scheda Aggiornamenti dell'App Store
Download Diretto: Controlla aggiornamenti in HarborDB → Controlla Aggiornamenti

3. Configura Preferenze (Opzionale)

Regola il tema (Chiaro/Scuro/Sistema)
Configura impostazioni connessione predefinite
Imposta scorciatoie da tastiera

Risoluzione Problemi di Installazione

Errore "App Danneggiata"

Se vedi "HarborDB.app è danneggiato e non può essere aperto":

# Apri Terminale ed esegui:
sudo xattr -cr /Applications/HarborDB.app

Permessi Insufficienti

Se HarborDB non può accedere alle risorse richieste:

Vai su Preferenze di Sistema → Sicurezza e Privacy → Privacy
Concedi i permessi necessari (Accessibilità, File e Cartelle, ecc.)
Riavvia HarborDB

Installazione Fallita

Se l'installazione fallisce o l'app non si avvia:

Riavvia il tuo Mac e riprova
Controlla lo spazio su disco - Assicurati di avere almeno 500 MB liberi
Verifica versione macOS - Controlla Informazioni su questo Mac → versione macOS
Contatta il supporto se i problemi persistono

Disinstallazione

Per rimuovere HarborDB dal tuo sistema:

Versione Mac App Store

Apri Finder → Applicazioni
Trascina HarborDB.app nel Cestino
Svuota il Cestino

Versione Download Diretto

Rimuovi l'applicazione da /Applications

Rimuovi le preferenze (opzionale):

rm -rf ~/Library/Preferences/com.harbordb.HarborDB.plist
rm -rf ~/Library/Application\ Support/HarborDB

Rimuovi le voci Keychain (opzionale) - Apri Accesso Portachiavi e cerca "HarborDB"

Prossimi Passi

Ora che HarborDB è installato:

Crea la tua prima connessione - Connettiti a un database PostgreSQL
Esplora l'interfaccia - Scopri le funzionalità di HarborDB
Prova query di esempio - Esercitati con SQL

Hai bisogno di aiuto? Consulta le nostre FAQ o contatta il supporto.

Installazione