DokuWiki

It's better when it's simple

User Tools

Site Tools


install

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
install [2017-10-03 17:07] 93.65.39.46install [2023-09-20 21:53] (current) – [Webserver Specifics] andi
Line 1: Line 1:
 ====== DokuWiki Installation===== ====== DokuWiki Installation=====
  
- +**In case an existing installation is to be upgraded, there are separate [[install:upgrade|upgrade instructions]].**
-**There are separate [[install:upgrade|upgrade instructions]] if you have an existing installation.**+
  
 Try these instructions first. If you still need help, follow one of the links below: Try these instructions first. If you still need help, follow one of the links below:
  
   * **Step 0:** Make sure your server meets the [[requirements]].   * **Step 0:** Make sure your server meets the [[requirements]].
-  * **Step 1:** Download the newest release from the [[http://download.dokuwiki.org/|Download Page]].+  * **Step 1:** Download the newest release from the [[https://download.dokuwiki.org/|Download Page]].
   * **Step 2:** Read the [[security|security page]] //before// you begin installing. Take it seriously. If in doubt, ask on the [[mailinglist| mailing list]]   * **Step 2:** Read the [[security|security page]] //before// you begin installing. Take it seriously. If in doubt, ask on the [[mailinglist| mailing list]]
   * **Step 3:** Unpack the distribution tarball and upload/copy the files to your webspace.   * **Step 3:** Unpack the distribution tarball and upload/copy the files to your webspace.
-  * **Step 4:** Open the install.php file in your browser and follow the instructions. (For additional information, see the [[installer]] page.) +  * **Step 4:** Open the install.php file in your browser and follow the instructions. (For additional information, see the [[installer]] page.) 
-  * **Step 5:** Enjoy your DokuWiki install and browse through the [[manual]] to discover what you can do with it.+  * **Step 5:** Enjoy your DokuWiki install and browse through the [[manual]] to discover what you can do with it.
  
 [[:install:screencast|A screencast of installing DokuWiki]] shows installation to a shared web hosting provider, but it may be useful for other situations as well. If you don't have a webhoster yet, check our [[hosting|hosting partners]] for a pre-installed DokuWiki. [[:install:screencast|A screencast of installing DokuWiki]] shows installation to a shared web hosting provider, but it may be useful for other situations as well. If you don't have a webhoster yet, check our [[hosting|hosting partners]] for a pre-installed DokuWiki.
  
-If you are looking to create multiple Wiki's, you can create a DokuWiki farm. This is similar to the idea of multi-sites. Instructions on how to do this manually are provided in the [[farms|Farm page]].+If you are looking to create multiple Wikis, you can create a DokuWiki farm. This is similar to the idea of multi-sites. Instructions on how to do this manually are provided in the [[farms|Farm page]].
  
 ===== Detailed Instructions ===== ===== Detailed Instructions =====
Line 30: Line 29:
 ==== Distribution/OS Specifics ==== ==== Distribution/OS Specifics ====
  
-  * [[http://wiki.archlinux.org/index.php/Dokuwiki|Arch Linux]]+  * [[https://wiki.alpinelinux.org/wiki/DokuWiki|Alpine Linux]] 
 +  * [[https://wiki.archlinux.org/index.php/Dokuwiki|Arch Linux]]
   * [[install:CentOS]]   * [[install:CentOS]]
   * [[install:Debian]]   * [[install:Debian]]
Line 37: Line 37:
   * [[install:Gentoo]]   * [[install:Gentoo]]
   * [[install:MacOSX]] or [[install:mac_alt]]   * [[install:MacOSX]] or [[install:mac_alt]]
 +  * [[install:OpenBSD]]
   * [[install:OpenSolaris]]   * [[install:OpenSolaris]]
   * [[install:openSUSE]]   * [[install:openSUSE]]
-  * [[http://wiki.qnap.com/wiki/Dokuwiki|QNAP NAS]]+  * [[https://wiki.qnap.com/wiki/Dokuwiki|QNAP NAS]]
   * [[install:Solaris]]   * [[install:Solaris]]
 +  * [[install:Synology]]
   * [[install:Ubuntu|Ubuntu]]   * [[install:Ubuntu|Ubuntu]]
   * [[install:Windows]]   * [[install:Windows]]
Line 49: Line 51:
     * [[install:darklight]]     * [[install:darklight]]
     * [[install:Hiawatha]]     * [[install:Hiawatha]]
 +    * [[install:httpd|httpd (BSD)]]
     * [[install:IIS]]     * [[install:IIS]]
     * [[install:Lighttpd]]     * [[install:Lighttpd]]
Line 55: Line 58:
     * [[install:nginx]]     * [[install:nginx]]
     * [[install:OpenLiteSpeed]]     * [[install:OpenLiteSpeed]]
 +    * [[install:caddy|Caddy(v2)]]
  
 ==== Web Host Specifics ==== ==== Web Host Specifics ====
Line 60: Line 64:
   * [[hosting|Hosting Partners]] provide pre-installed DokuWiki setups   * [[hosting|Hosting Partners]] provide pre-installed DokuWiki setups
   * DokuWiki on...   * DokuWiki on...
 +    * [[install:Amazone EC2|Amazon EC2]]
 +    * [[install:civihosting.com|CiviHosting]]
     * [[install:dreamhost|Dreamhost]]     * [[install:dreamhost|Dreamhost]]
     * [[install:free.fr|free.fr]]     * [[install:free.fr|free.fr]]
Line 68: Line 74:
     * [[install:sourceforge|SourceForge]]     * [[install:sourceforge|SourceForge]]
     * [[install:strato|Strato and 1&1]]     * [[install:strato|Strato and 1&1]]
-    * [[install:Amazone EC2|Amazon EC2]] 
  
 +Some web hosts have DokuWiki included in their list of installable packages making the install almost automatic.
  
-Some web hosts have DokuWiki included in their list of installable packages making the install almost automatic. 
 ==== Alternative Install Methods ===== ==== Alternative Install Methods =====
-    * [[https://cloudron.io|Cloudron.io]] has  a [[https://cloudron.io/appstore.html#org.dokuwiki.cloudronapp|DokuWiki App]] that can be installed on your Cloudron Smartserver. They actively track DokuWiki releases ([[https://git.cloudron.io/cloudron/dokuwiki-app|source]]) keeping your installation up-to-date.+    * [[https://github.com/KissConsult/dokuwiki|IBM Cloud]] is a hybrid cloud platform , on which you can install Dokuwiki with a couple of clicks on a kubernetes cluster with bitnami charts 
 +    * [[https://cloudron.io|Cloudron]] is a complete solution for running apps on your server and keeping them up-to-date and secure. There is a [[https://cloudron.io/appstore.html#org.dokuwiki.cloudronapp|DokuWiki App]] for Cloudron. They actively track DokuWiki releases ([[https://git.cloudron.io/cloudron/dokuwiki-app|source]]) and push automatic updates[[https://my.demo.cloudron.io/|Demo]] (username: cloudron password: cloudron)
     * [[install:downloader|DokuWiki Downloader]] -- a single script that takes care of downloading and installing DokuWiki     * [[install:downloader|DokuWiki Downloader]] -- a single script that takes care of downloading and installing 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]].     * [[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]].
Line 79: Line 85:
     * [[http://bitnami.org/stack/dokuwiki|DokuWiki Bitnami Stack]] -- an installer which deploys DokuWiki and all that's necessary to run it (Apache, PHP). Available for Windows, Linux, Mac x86, Mac PPC, Solaris x86 and Solaris SPARC.     * [[http://bitnami.org/stack/dokuwiki|DokuWiki Bitnami Stack]] -- an installer which deploys DokuWiki and all that's necessary to run it (Apache, PHP). Available for Windows, Linux, Mac x86, Mac PPC, Solaris x86 and Solaris SPARC.
     * [[http://bitnami.org/stack/dokuwiki|DokuWiki Bitnami Module]] -- an installer which deploys DokuWiki on top of LAMPStack if you are using Linux, or MAMPStack, WAMPStack or SAMPstack if you are using Mac, Windows or Solaris allowing to share database, webserver and language runtime with other applications modules.       * [[http://bitnami.org/stack/dokuwiki|DokuWiki Bitnami Module]] -- an installer which deploys DokuWiki on top of LAMPStack if you are using Linux, or MAMPStack, WAMPStack or SAMPstack if you are using Mac, Windows or Solaris allowing to share database, webserver and language runtime with other applications modules.  
-    * [[http://sourceforge.net/projects/desktopwiki/|Desktop Wiki]] -- another portable DokuWiki, but it is seemingly unmaintained (not updated since 2013) 
     * [[devel:git#maintaining_a_stable_version_with_git|Using Git to handle the installation]]     * [[devel:git#maintaining_a_stable_version_with_git|Using Git to handle the installation]]
-    * [[https://sourceforge.net/projects/dokuwikispatial/files/DokuWiki%20portable/|Portable DokuWiki using Uniform Server PHP MicroServer]] +    * For local desktop wiki (on any OS) install using [[install:php-webserver|PHP builtin web server]].
-    * [[https://www.synology.com/|Synology NAS]] operating system "Disk Station Manager" provides DokuWiki package for easy installing+
  
 ===== Pitfall on suhosin PHP extension ===== ===== Pitfall on suhosin PHP extension =====
Line 102: Line 106:
   * Check the [[security]] page again   * Check the [[security]] page again
   * Consider enabling [[rewrite|URL rewriting]]   * Consider enabling [[rewrite|URL rewriting]]
-  * Choose a license for your content---use config [[config:license]] or edit the ''footer.html'' inside the dokuwiki/lib/tpl/... folder if your template doesn't use ''tpl_licence()'' introduced with DokuWiki 2009-02-14.+  * Choose a license for your content---use config [[config:license]] 
   * Enter a few words how and where you use [[DokuWiki]] in the [[dokuinstall|userpage]]   * Enter a few words how and where you use [[DokuWiki]] in the [[dokuinstall|userpage]]
-  * Subscribe to the [[newsletter]] 
   * Read:   * Read:
     * [[faq|Frequently Asked Questions]]     * [[faq|Frequently Asked Questions]]
Line 110: Line 113:
     * [[tips|tips and tricks]], especially [[tips:tailorwikirules|best-practices]] to follow after installing     * [[tips|tips and tricks]], especially [[tips:tailorwikirules|best-practices]] to follow after installing
  
-===== It Doesn't Work! Troubleshooting ===== 
  
 If you've encountered problems installing DokuWiki, and you've carefully checked each of the steps above: If you've encountered problems installing DokuWiki, and you've carefully checked each of the steps above:
  
-  * [[http://download.dokuwiki.org/|Download the source package]] again to ensure you do not have a corrupt download+  * [[https://download.dokuwiki.org/|Download the source package]] again to ensure you do not have a corrupt download
   * Upload your files again---FTP corruption is a common cause for problems. Uploading a zip file and extracting on the server may be more reliable than uploading files individually   * Upload your files again---FTP corruption is a common cause for problems. Uploading a zip file and extracting on the server may be more reliable than uploading files individually
   * Double and triple check [[install:permissions|file and folder permissions]] -- this is a **very** common cause of problems   * Double and triple check [[install:permissions|file and folder permissions]] -- this is a **very** common cause of problems
- +  * Be sure to [[https://forum.dokuwiki.org/|search the forum]] before posting your questions to the [[https://forum.dokuwiki.org/t/install-config|installation forum]].
-  * Be sure to [[http://forum.dokuwiki.org/search|search the forum]] before posting your questions to the [[https://forum.dokuwiki.org/forum/2/|installation forum]] +
- +
install.1507043248.txt.gz · Last modified: 2017-10-03 17:07 by 93.65.39.46

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki