# App/Xtn/Browser/HTTP Server

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

## Credits

Considerable thanks goes to Mattze96 for proposing and developing the HTTP server.

## Overview

As of v0.12.1, XOWA now includes an HTTP server in addition to a TCP server. The TCP server is used by the Firefox Add-On (See App/Xtn/Browser/XOWA_viewer).

If you are using Firefox, the Firefox Add-On is the recommended solution for using XOWA within a browser. However, if you want to use XOWA from another browser (for example, Google Chrome) or across the network, you will want to use the HTTP server instead.

Note that the HTTP server is currently in an alpha stage, but should improve with coming releases. If you have any comments or feedback, please see https://sourceforge.net/p/xowa/discussion/general/thread/fa4baf84/

## Usage

### Other browsers

To use the XOWA HTTP server in another browser, do the following:

- Launch XOWA with the following command line: `java -jar /xowa/xowa_linux.jar --app_mode http_server --http_server_port 8080`[1]
- Launch your browser and navigate to `localhost:8080`

### Across the network

To use the XOWA HTTP server in a server setting, do the following:

- Launch XOWA on the server machine with the command line `java -jar /xowa/xowa_linux.jar --app_mode http_server`
- Launch your browser on a client machine and navigate to the IP Address of the server machine. `192.168.0.100:8080`

## Notes

1. ^ Note that you will need to run XOWA as root if you choose to pass port 80 for http_server_port.

### 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
- XOWA