Differences

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

--- install:dokuwiki_on_a_stick [2013-04-17 16:53] – [How to install and setup] 195.234.134.115
+++ install:dokuwiki_on_a_stick [2023-07-29 15:53] (current) – First sentence highlighted michaelsy
@@ Line 1: / Line 1: @@
 ====== DokuWiki on a Stick ======
-**DokuWiki on a Stick** is a preconfigured [[wiki:dokuwiki|DokuWiki]] installation which comes with its own [[http://microapache.kerys.co.uk|stripped down Apache webserver]]. This allows you to run DokuWiki from a portable device like an USB stick on any Windows computer without installing anything on the computer itself.((http://www.splitbrain.org/blog/2008-05/16-dokuwiki_on_a_stick_2008-05-05))
+**DokuWiki on a Stick is the portable version of [[wiki:dokuwiki|DokuWiki]].** It contains [[https://github.com/splitbrain/dokuwiki-stickbuilder|its own stripped down Apache webserver]]. This allows you to run DokuWiki from a portable device like an USB stick on any Windows computer without installing anything on the computer itself.((http://www.splitbrain.org/blog/2008-05/16-dokuwiki_on_a_stick_2008-05-05)) Of course, you can also copy it to any directory on your hard disk and run it from there.
+===== Requirements =====
+  * The current (July 2022) latest stable version (incl. Apache 2.4.46 & PHP 7.4.12) requires Windows 7 or higher.((Earlier versions are available, see "Old Releases" below.))
+  * Microsoft Visual Studio runtime libraries.
 ===== Download =====
-This is the Release Candidate for the next stable release.
-  * [[https://docs.google.com/uc?id=0B-44TtfOk4R2RVQzazMtVjRSUFU&export=download&hl=en_US|DokuWiki on a Stick rc2013-03-06 “Weatherwax RC1”]] (bundled with MicroApache 2.0.64, PHP 5.2.17, GD2 and SQLite)
-This is the current “stable” version of DokuWiki on a Stick.
+To create an "on the Stick" edition of DokuWiki, visit [[http://download.dokuwiki.org|download.dokuwiki.org]] and check the "MicroApache (Windows)" checkbox in the "Include Webserver" section.
-  * (will be updated when “Weatherwax" has been released)
-For the latest updates you can follow [[http://twitter.com/dokuwiki_stick|dokuwiki_stick on Twitter]] or [[http://identi.ca/dokuwikistick|dokuwikistick on identi.ca]]!
+[[install:unpacking|Unpack]] the downloaded archive file and move the resulting ''DokuWikiStick'' to your USB thumb drive.
+===== Usage =====
+You'll find a ''run.cmd'' file in the ''DokuWikiStick'' directory. Double click it and the MicroApache webserver will start up and open your wiki in the system's default browser. On the first time it will open the usual [[:installer|DokuWiki Installer]] where you can configure the basic settings. Later it will simply load your wiki's start page at http://localhost:8800/
+In case the stop command in the run.cmd does not work, try to use the command
+**taskkill /f /im mapache.exe**
+which will kill the mapache.exe instances on your machine and also exits the DOS shell.
+===== Updating =====
+You can update your Stick Edition just like a normal DokuWiki installation by downloading a new package and overwrite the existing files. (See [[install:upgrade|Upgrading DokuWiki]]).
+An even easier method is to install the [[plugin:upgrade|Upgrade Plugin]].
+===== Tips and Technical Background =====
+  * [[http://www.splitbrain.org/blog/2011-01/16-dokuwiki_on_a_stick_in_dropbox|DokuWiki on a Stick in DropBox]]
+  * [[dokuwiki_on_a_stick_Linux|Dokuwiki on a stick for windows and Linux Execution]]
+  * [[https://forum.dokuwiki.org/post/63251|DokuWiki on a Stick on a Windows-UNC-Share (German)]]
+  * [[https://forum.dokuwiki.org/d/20200-many-instances-of-dokuwiki-on-a-stick/8|More than one instance of Dokuwiki-on-a-stick]]
+  * [[https://forum.dokuwiki.org/d/17171/5|Understand how DokuWiki works]]
 ===== Old Releases =====
 These releases are no longer recommended for usage and are listed for reference only.
+  * [[https://docs.google.com/uc?id=0B-44TtfOk4R2RVQzazMtVjRSUFU&export=download&hl=en_US|DokuWiki on a Stick rc2013-03-06 “Weatherwax RC1”]] (bundled with MicroApache 2.0.64, PHP 5.2.17, GD2 and SQLite)
   * [[https://brezn.muc.ccc.de/~str/dokuwiki/dokuwikistick-2010-11-07a.zip|DokuWiki on a Stick 2010-11-07a “Anteater”]] (bundled with the latest MicroApache 2.0.63, PHP 5.2.9, GD2 and SQLite)
   * [[https://brezn.muc.ccc.de/~str/dokuwiki/dokuwikistick-2010-11-07.zip|DokuWiki on a Stick 2010-11-07 “Anteater”]] (bundled with the latest MicroApache 2.0.63, PHP 5.2.9, GD2 and SQLite)
@@ Line 26: / Line 55: @@
   * [[http://www.splitbrain.org/_media/blog/2007-12/dokuwikistick-2007-06-26b.zip|DokuWiki on a Stick 2007-06-26b]] (bundled with MicroApache 2.0.61, PHP 4.4.7 and GD2)
-===== Credits & Licenses =====
-  * **MicroApache** is maintained by M. Shaw. The Micro-Apache suite is licensed under [[http://www.apache.org/licenses/GPL-compatibility.html|Apache GPL licence]].
-  * **DokuWiki** is maintained by Andreas Gohr and the DokuWiki Community. The DokuWiki engine is licensed under [[http://www.gnu.org/licenses/gpl.html|GNU General Public License]] Version 2.
-  * **DokuWiki on a Stick** is maintained by [[user>str]]
-===== Usability =====
-  * [[http://www.splitbrain.org/blog/2011-01/16-dokuwiki_on_a_stick_in_dropbox|DokuWiki on a Stick in DropBox]]
-===== Discussion =====
-==== How to install and setup ====
-  * Download
-  * Unzip to the stick
-  * Find **//go.bat//** in the folder **//DokuWikiStick//** and run it
-  * Open ''http://localhost:8800/install.php'' in your browser
-  * Enter your information and you are done
-==== Usage with external DokuWiki folder ====
-To use **DokuWiki on a Stick** with a pre-existing DokuWiki in another folder I was successful in just changing the ''DocumentRoot'' parameter in ''conf/httpd.conf'' as shown:
-<code>
-# From...
-# DocumentRoot ./dokuwiki
-# ...to...
-DocumentRoot ./../../Public_HTML/wiki
-</code>
-I wanted this so I could edit the local copy of my website when I didn't have access to the webserver.  I am pleased to see it worked!
-==== Startup script ====
-Here's a little command script that simplifies starting/stopping the server:
-<file dos start.cmd>
-@echo off
-goto begin
-:usage
-echo Usage: %~n0
-echo.
-echo Starts DokuWiki on a Stick (http://www.dokuwiki.org/dokuwiki_on_a_stick)
-echo and waits for user to press a key to stop.
-goto end
-:begin
-if not "%1"=="" goto usage
-start "MicroApache server" mapache.exe
-echo DokuWiki on a Stick started . . .
-echo.
-:runbrowser
-echo Your web browser will now open to http://localhost:8800 . . .
-echo.
-start http://localhost:8800
-:wait
-echo To stop DokuWiki on a Stick
-pause
-:stop
-stop
-echo . . . DokuWiki on a Stick stopped.
-:end
-</file>
-==== Bug: Can't download plugins from github, except from cloud.github ====
-I'm not sure where else to report this, but I just noticed that the plugin manager in Dokuwiki-on-a-stick is unable to download plugins from http://github.com, but can download plugins from http://cloud.github.com. Take for example, [[http://github.com/downloads/chimeric/dokuwiki-plugin-medialist/plugin-medialist.tgz|medialist]] or [[http://github.com/marklundeberg/dokuwiki-plugin-latex/tarball/master|latex]].... on the other hand, [[http://cloud.github.com/downloads/chimeric/dokuwiki-plugin-medialist/plugin-medialist.tgz|this link to medialist]] does work. Eh? Weird. (since both links work fine from, e.g., firefox).  --- [[user>nanite|nanite]] //2011/04/29 09:52//
-> This effects DokuWiki in general. It's because the non-working URLs you mentioned are dynamic (the files given back are not always the same, hence not static) and it seems the DokuWiki plugin downloader can't handle that. For example the current static URL to the LaTeX-plugin would be: http://download.github.com/marklundeberg-dokuwiki-plugin-latex-5b969ec.tar.gz which works fine. It seems the automatic plugin downloader also doesn't work with SSL encrypted HTTP (HTTPS) URLs. Maybe you want to submit this problem to [[http://bugs.dokuwiki.org/|bugs.dokuwiki.org]], eventually the developers know how to solve it for future versions. --- . 2011/04/30 22:28
-==== PROBLEM on Download ====
-due to certificate problem I cannot download the SW from Brezn server. Is there any other download source available ?
-//[NGN]// I have the same problem.
-Same here. I've done some looking around and can find no other source. Best solution here is to resolve the certificate issue a.s.a.p.
-==== Question ====
-the Rincewind release date of the "on a stick" version is one month older than the Rincewind release for web servers. \\
-What are the differences or is there an update planned in the near future for the "on a stick" version ?
-==== More info needed on how to use it ====
-Assuming the files become available on a server that Firefox trusts, what do I next? I'm not used to running things from a stick, and I've never installed anything on a stick either. Help topics would need to include:
-  * what files to copy to the stick
-  * how to start dokuwiki on the stick
-  * how to add plugins to the stick
-  * how to stop dokuwiki on the stick
-It sounds like a great idea I could use with several clients, but I don't want to fall flat on my face by starting a demo and hitting problems!
-Answering my own question … you could put the Quickstart readme on this site, just to show how easy it is.
-==== Malware Warning From Webroot ====
-My Webroot antivirus detected a "W32.Malware.Gen" threat in the php5apache2.dll files of both the Anteater and Rincewind versions of the Dokuwiki on a stick. I don't know enough about apache or PHP to say whether or not this is a false positive. Thought it should be highlighted since I couldn't find any documentation concerning this.
-The warning comes up only from the zip files while compressed. After extraction the file which gives the warning is not present in the new directory.
->I also received a malware warning (on AVG), though this is on running the server executable. This little conundrum, together with the certificate issues regarding the download link, is making me suspect that the download might have been compromised.
-===== Easy update to dokuwiki on a stick. =====
-"Updated" versions of DokuWiki on a Stick are available at  [[http://www.dokuwiki.org/dokuwiki_on_a_stick|dokuwiki_on_a_stick]] but there may be a delay in the upgrade when a new version comes out.
-For this post the files you download would be dokuwikistick-rc2011-04-22.zip and dokuwiki-2011-05-25a.tgz  so as you can see the stick version is way behind (this was posted late Sept 2011)
-The easy way to update a fresh install is down load both  dokuwiki on a stick and the [[http://www.splitbrain.org/projects/dokuwiki|latest stable]] or nightly version.
-Extract the files to the folder of your choice the dokuwiki may have to be extracted twice, second time if you have write errors rename the destination folder to doku.
- \\
-  * **Backup [[http://www.dokuwiki.org/faq:backup]] first**
-  * remove Dokuwiki folder contents from Dokuwiki on a stick
-  * drag and drop the update into the dokuwiki folder.
-  * then go through the **install new version process**; - localhost:dokuwiki\admin\install.php (you must go through details to setup the wiki, but they will be overwritten by your original data in the next step)
-  * next drop backed up folders in place.
- \\  Wiki is then uptodate.
-**SteveC**
-==== DokuWiki on a Stick ====
-from within [[http://www.splitbrain.org/blog/2011-01/16-dokuwiki_on_a_stick_in_dropbox|dropbox]]