====== Installazioni di DokuWiki ======

**Ci sono separate [[install:upgrade|upgrade instructions]] se si dispone di una installazione esistente.**

Installare [[DokuWiki]] è molto semplice - in generale è solo un problema di spacchettamento e impostazione dei permessi. Si dovrebbero provare prima le semplici istruzioni fornite qui, se si incontrano problemi o se le istruzioni non sono sufficientemente dettagliate, si segua uno dei successivi collegamenti.

  * **Passo 1:** Si scarichi l'ultima versione da [[http://download.dokuwiki.org/|Download Page]].

  * **Passo 2:** Si legga la pagina sulla [[security|sicurezza]] //prima// di iniziare l'installazione. La si consideri seriamente. In caso di dubbi, si chieda sulla [[mailinglist| mailing list]]

  * **Passo 3:** Si scompatti la distribuzione e si carichino/copino i file sul proprio spazio web.

  * **Passo 4:** Si apra il file install.php nel navigatore e si seguano le istruzioni.  (Per ulteriori informazioni, si consulti la pagina [[installer|installatore]])

  * **Passo 5:** Ci si goda la propria installazione di DokuWiki e si navighi nel [[manual|manuale]] per scoprire cosa si può fare.

[[:install:screencast|Un video]] mostra l'installazione di DokuWiki su hosting Web condiviso, ma può essere utile anche in altre situazioni.


===== Istruzioni dettagliate =====

Se si incontrano problemi seguendo i passi di cui sopra o si ha necessità di alcune informazioni dettagliate per uno dei passaggi si consultino queste pagine:

  * [[install:unpacking|Extracting a .tgz archive]]
  * [[install:permissions|How to set up permissions]]
  * [[install:hosted|Installing DokuWiki on Hosted Webspace]]
  * [[installer|install.php instructions]]
  * [[install:upgrade|Upgrading from a previous Version]]
  * [[FAQ|Frequently Asked Questions]]
==== Distribuzioni/sistemi operativi specifici ====

    * [[install:Debian]]
    * [[install:Gentoo]]
    * [[install:FreeBSD]]
    * [[install:MacOSX]] or [[.install:mac_alt]] FIXME
    * [[install:OpenSolaris]]
    * [[install:Solaris]]
    * [[http://wiki.archlinux.org/index.php/Dokuwiki|Arch Linux]]
    * [[install:openSUSE|openSUSE]]
    * [[install:Ubuntu|Ubuntu]]
    * [[install:Fedora]]
    * [[install:Windows]]
    * NETGEAR ReadyNAS (coming soon)
    * Synology Diskstation NAS?
    * QNAP NAS?
    * [[install:Slax|SLAX]]

==== Specifici server Web ====

    * [[install:Lighttpd]]
    * [[install:Nanoweb]]
    * [[install:IIS]]
    * [[install:nginx]]

==== Web Host Specifici ====

    * [[install:hosted|Installing DokuWiki on Hosted Webspace]]
    * [[install:dreamhost|DokuWiki on Dreamhost]]
    * [[install:godaddy.com|DokuWiki on GoDaddy]]
    * [[install:free.fr|DokuWiki on free.fr]]
    * [[install:sourceforge|DokuWiki on SourceForge]]
    * [[install:strato|DokuWiki on Strato and 1&1]]

==== Metodi di installazione alternativi ====

    * [[install:downloader|DokuWiki Downloader]] -- in un unico script scaricare e installa DokuWiki
    * [[http://www.turnkeylinux.org/dokuwiki|TurnKey DokuWiki Appliance]] -- a free open source virtual appliance based on Ubuntu that's easy to use and lightweight. Auto-updated daily with latest security patches. Deploys in minutes to a Virtual Machine, bare metal, or in the cloud. Part of the [[http://www.turnkeylinux.org|TurnKey Linux Virtual Appliance Library]].
    * [[install:dokuwiki_on_a_stick|DokuWiki on a Stick]] -- per eseguire DokuWiki direttamente da chiavetta USB
    * [[http://bitnami.org/stack/dokuwiki|DokuWiki Bitnami Stack]] -- un installer distribuito con DokuWiki e tutto il necessario per farlo funzionare (Apache, PHP). Disponibile per Windows, Linux, Mac x86, Mac PPC, Solaris x86 e Solaris SPARC.
    * [[http://bitnami.org/stack/dokuwiki|DokuWiki Bitnami Module]] -- un installer distribuito con un sistema LAMPStack se si utilizza Linux, o MAMPStack, WAMPStack SAMPstack o se si utilizza Mac, Windows o Solaris Permettendo di condividere dati, web server e linguaggi che girano con altre applicazioni e moduli. 
    * [[http://www.shareknow.cn/desktop_wiki|Desktop Wiki]] -- un altro DokuWiki portatile
    * [[devel:git#maintaining_a_stable_version_with_git|Usare Git per gestire l'installazione]]

===== Funziona! E ora? =====

Ecco cosa si può fare quando è tutto pronto e funzionante:

  * Si controlli ancora la pagina [[security]] ;-)
  * Si consideri di attivare [[rewrite|URL rewriting]]
  * Si scelga una licenza per il proprio contenuto -- si usi config [[config:license]] o si editi ''footer.html'' dentro la cartella dokuwiki/lib/tpl/... se il proprio tema non usa tpl_licence() introdotto con DokuWiki 2009-02-14.
  * Si inserisca qualche parola su come e dove è usato [[DokuWiki]] in [[::dokuinstall|userpage]]
  * Ci si iscriversi alla [[newsletter]]
  * Si legga:
    * [[faq|Risposte alle domande frequenti]]
    * [[tips:maintenance|day-to-day maintenance needed for DokuWiki]]
    * [[tips|trucchi e consigli]], specialmente [[tips:tailorwikirules|best-practices]] da seguire dopo l'installazione



===== Non funziona! Risoluzione dei problemi =====

Se si sono riscontrati problemi nell'installazione di DokuWiki, e si sono eseguiti tutti i passi di cui sopra:

  * [[http://download.dokuwiki.org/|Si scarichi il pacchetto sorgente]] nuovamente per assicurarsi di non avere un pacchetto danneggiato 
  * si carichino i fili ancora - la corruzione FTP è una comune causa di problemi.  Caricare il pacchetto zip ed estrarlo sul server può essere più affidabile che caricare i file individualmente
  * si controllino due e tre volte [[install:permissions|file and folder permissions]] - questa è una causa **molto** comune di problemi
  * assicurarsi di [[http://forum.dokuwiki.org/search|cercare nel forum]] prima di pubblicare le proprie domande nel [[http://forum.dokuwiki.org/forum/2/|installation  forum]]