Difference between revisions of "Deployment/howto"

Jump to navigation Jump to search
Line 51: Line 51:
But, because kiwix-serve is less developed as kiwix, both still work a little bit differently. [[Kiwix-serve]] does not work with libraries, we still do not have implemented that. To run kiwix-serve, you simply need to have a ZIM file and a fulltext search index in option. To build the fulltext search index, you need the kiwix-index binary which is trivial to use. Currently, kiwix-serve only runs on GNU/Linux. If you have a permission issue, please you a port over 1024, otherwise, you will need root permission to run it.
But, because kiwix-serve is less developed as kiwix, both still work a little bit differently. [[Kiwix-serve]] does not work with libraries, we still do not have implemented that. To run kiwix-serve, you simply need to have a ZIM file and a fulltext search index in option. To build the fulltext search index, you need the kiwix-index binary which is trivial to use. Currently, kiwix-serve only runs on GNU/Linux. If you have a permission issue, please you a port over 1024, otherwise, you will need root permission to run it.


= Deploying ==
= Deploying =


Kiwix works without installation
There are many way to deploy kiwix over network of using removable mass storage solution like DVDs or USB sticks. Here are a few remarks:
Take care to the OS and architectures.


== Deployment Options ==
* ''Kiwix works without installation'', so you do not need to install it on the system (with administrator permission) to have a 100% working solution. Copy the data somewhere and the hard-disk and it will work. The only advantages to install it, is to have it for all users having an account on the computer and have nice icons in the application menu or associated to the ZIM files.


=== Single of few computers ===
* ''Take care to the OS'', OSes have their own restrictions and specificities. For example, this is not possible to have a portable version (everything running on a DVD/USB stick) with OSX, because for OSX, we only have a dmg file. On Linux, you can not really make a portable version because, removable storage are per default mounted with -noexe permission, so you will have to copy everything to the harddisk.


=== School Lab ===
* ''Take care to architectures''. All kiwix binaries available to download on the Web site are statically linked binaries compiled for x86 32 architectures. All of them should work also on x86 64 architectures (for GNU/Linux: as long as the standart libs in 32 bits are installed).


=== Conference ===
* Linux and usb stick


=== EOM ===
* On ubuntu with pacakges
 
== Low-End Computers Optimizations ==
 
== Rural-friendly computers ==
 
== No Grid Electricity Alternatives ==


= Getting Support & Assistance =
= Getting Support & Assistance =