DokuWiki

It's better when it's simple

User Tools

Site Tools


install:dokuwiki_on_a_stick

This is an old revision of the document!


DokuWiki on a Stick

DokuWiki on a Stick is a preconfigured DokuWiki installation which comes with 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.1)

Download

This is the Release Candidate for the next stable release.

This is the current “stable” version of DokuWiki on a Stick.

  • (will be updated when “Weatherwax“ has been released)

For the latest updates you can follow dokuwiki_stick on Twitter or dokuwikistick on identi.ca!

Old Releases

These releases are no longer recommended for usage and are listed for reference only.

Credits & Licenses

  • MicroApache is maintained by M. Shaw. The Micro-Apache suite is licensed under Apache GPL licence.
  • DokuWiki is maintained by Andreas Gohr and the DokuWiki Community. The DokuWiki engine is licensed under GNU General Public License Version 2.
  • DokuWiki on a Stick is maintained by str

Usability

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:

# From...
# DocumentRoot ./dokuwiki
# ...to...
DocumentRoot ./../../Public_HTML/wiki

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:

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

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, medialist or latex…. on the other hand, this link to medialist does work. Eh? Weird. (since both links work fine from, e.g., firefox). — 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 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 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 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.


  • 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 dropbox

install/dokuwiki_on_a_stick.1365672272.txt.gz · Last modified: 2013-04-11 11:24 by 195.62.48.10

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