# App/Setup/Installation

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

## Download and unzip XOWA

- Download a package for your operating system from https://github.com/gnosygnu/xowa/releases/ For example, if you're using Windows, you would download `xowa_app_windows_v3.1.1.1.zip`.
- Unzip to a folder. See the XOWA Folder section below for possible choices.
- When finished, you will have a file called `readme.txt` 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_Name/xowa/xowa_linux.sh`

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

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

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

## XOWA folder

XOWA works from one folder. For the purpose of the instructions throughout this wiki, 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
--- | --- | ---
Windows | C:\xowa\ | C:\xowa\xowa_windows.jar
Linux | /home/Your_Name/xowa/ | /home/Your_Name/xowa/xowa_linux.jar
OS X | /Users/Your_Name/xowa/ | /Users/Your_Name/xowa/xowa_macosx.jar

### XOWA

- Main page
- Screenshots
- Video
- Download XOWA
- Download wikis

### Getting started

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

### Android

- Setup
- Video

### Help

- About
- Contents
- Media
- Feedback

### Blog

- Current

### Links

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

### Donate

- archive.org
- Wikipedia