# Installation

From XOWA: a free, open-source, offline wiki application

## Choose a folder

XOWA works from one folder. For the purpose of these instructions, this folder will be referred to as /xowa/.

The table below lists recommended locations by operating system. Note that these are just recommendations: you can use any other folder on your hard drive (or on a flash memory card).

operating system | folder | path of xowa jar
--- | --- | ---
Linux | /home/your_user_name/xowa/ | /home/your_user_name/xowa/xowa_linux.jar
OS X | /Users/your_user_name/xowa/ | /Users/your_user_name/xowa/xowa_macosx.jar
Windows | C:\xowa\ | C:\xowa\xowa_windows.jar

## Download XOWA

- Download an "xowa_app_*.zip" from the download page
- Unzip to the xowa root folder. When finished, you will have a file called /xowa/xowa.gfs as well as many other files and directories.

## Run XOWA

- On Windows, double-click C:\xowa\xowa.exe
- On Linux, open a terminal and run `sh /home/your_user_name/xowa/xowa_linux.sh`

  Note that the shell script is a wrapper for `java -Xmx256m -jar /home/your_user_name/xowa/xowa_linux.jar`

- On OS X, open a terminal and run `sh /Users/your_user_name/xowa/xowa_macosx.sh`

  Note that the shell script is a wrapper for `java -Xmx256m -d32 -XstartOnFirstThread -jar /Users/your_user_name/xowa/xowa_macosx.jar`

### XOWA

- Main page
- Screenshots
- Download XOWA
- Download wikis

### Getting started

- Requirements
- Installation
- Simple Wikipedia
- English Wikipedia
- Other Wikipedias

### Android

- Setup

### Help

- About
- Contents
- Media
- Feedback

### Blog

- Current

### Links

- Wikimedia dumps
- XOWA @ archive.org
- English Wikipedia

### Donate

- archive.org
- Wikipedia