# Dev/File/Setup/Linux

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

XOWA recommends that Linux users download and install ImageMagick and Inkscape according to their distribution requirements.

Ubuntu instructions are listed below. Other distro-specific instructions will be added as feedback is received.

After ImageMagic and Inkscape are installed, you must click the following link to update XOWA's config:

update xowa config ⊗

. You can also configure this option at Options/Files

For more information about the config, see the section below.

## Ubuntu

Ubuntu users should run the following in a terminal:

    sudo apt-get install imagemagick
    sudo apt-get install inkscape

## Config (all distros)

### Enable images

- Navigate to Options and check "Download enabled"
- Restart XOWA and navigate to any page. Any images will be downloaded automatically.

### Paths

Note that XOWA assumes that ImageMagick and Inkscape have the following paths:

- /usr/bin/identify
- /usr/bin/convert
- /usr/bin/inkscape

If these paths are different on your system, you will need to update the config file. Instructions are provided below. If you run into issues, you may want to visit Dev/Config_files for more information.

- Open /xowa/xowa.gfs in a text editor.
- Search for `.cmd_('/usr/bin/identify')`
- Update the path to whatever it is on you system.
- Repeat for the other paths
- Save the file and restart XOWA.

## ImageMagick source

If you need to compile ImageMagick from source, you can try the following:

- Navigate to the http://www.imagemagick.org/script/install-source.php
- Download tar.gz.
- Unpack the archive to your home directory (EX: /home/username/imageMagick)
- Run the following from a terminal

    ./configure
    make
    sudo make install
    sudo ldconfig /usr/local/lib

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