This page hosts user contributed installation guides and HowTo's for various operating systems and distributions.
Note: The system-specific installation notes provided here are community contributions, generally added by someone who used the system in question and wanted to share the install procedure with the user community. They are not all continuously updated by their contributors, and some may be out-of-date (a good clue that a set of instructions is out of date would be any reference to CVS). Please bring outdated instructions to the attention of the user community on the xastir mailing list.
Beginning with release 2.1.8 of Xastir, the "tarball" versions of Xastir no longer contain "configure" scripts, and it is essential to run "bootstrap.sh" to create the configure script after unpacking. This makes the instructions for building "tarball" releases exactly the same as for building from a git clone. The individual system-specific pages have NOT been updated with this information. Please read the section of the install guides describing building from a git clone for the correct instructions for building tarball releases of Xastir 2.1.8 and later.
Attention Raspberry Pi enthusiasts! See instructions under "Raspbian" below.
Contents
BEFORE YOU BEGIN
All of the build instructions below assume you are following directions in order. If you skip any steps, notably in the instructions of what prerequisite packages or tools to install, some step will fail. At any stage, if you see error messages about tools, libraries, or headers missing, it means you skipped a step, or some prior step had an error message that you didn't pay attention to. Please review the instructions line by line and make sure you've installed everything we told you to install before attempting the next step. By far, some of the most common complaints we get about the installation of Xastir are the result of missing packages due to incorrectly copied command lines or skipped steps.
For the impatient
- Barebones Install Guide, compiling from sources
General Notes
Android
- Android_via_GNUroot_and_XSDL - Installing Xastir using GNUroot & XSDL Xserver
BSD/Solaris/AIX...
- FreeBSD - Install on FreeBSD
Linux
Arch
- Install xastir-cvs in the Arch User Repository
CentOS
- CentOS 6.5 - see the HowTo:Fedora notes, below.
- HowTo:CentOS_5.2 - Installing and tweaking Xastir from source on CentOS 5.2
Debian
- HowTo:Debian Stretch or Jessie - How to install XASTIR on Debian Stretch or Jessie from Source via Github
- HowTo:Ubuntu/Debian - General how to install XASTIR on Ubuntu or Debian based systems. Also see Ubuntu-specific section below.
Fedora
- Fedora -- use "yum install xastir" (works, but not always the latest features)
- HowTo:Fedora - Installing Xastir from CVS (Fedora 7 through Fedora 20. Also known to work with CentOS and other RedHat like distros.)
- HowTo:AX25_Fedora Using Kernel level AX.25 Network services with Xastir and Fedora (Fedora 9 and later)
- HowTo:Fedora6 - Install FC-6 Linux + Xastir
GenToo
- GenToo Linux -- use "emerge xastir"
Linux Mint
- HowTo:Linux Mint Debian - How to install XASTIR on Linux Mint Debian
OpenSuSE
- HowTo:OpenSUSE 11.x - Install notes for OpenSuSE-11/12/13/42/15
- HowTo:OpenSUSE 10.2 - How to install on OpenSUSE 10.2 from Git
- Notes:OpenSuse 10.x - Install notes for OpenSuse 10.x
Raspbian
- HowTo:Raspbian - How to install XASTIR on Raspbian (Stretch, Jessie, or Buster) from Source via Github
- HowTo:Raspbian Jessie - How to install XASTIR on Raspbian Jessie from Source via Github
Ubuntu
- HowTo:Ubuntu 14.04-18.04 - How to install Xastir from Github on Ubuntu 14.04 thru 18.04
- HowTo:Ubuntu/Debian - General how to install XASTIR on Ubuntu or Debian based systems.
Mac OS X
There are a few different ways to install on Mac OS X:
- Install VMWare Fusion (Free trial) from VMWare.com and one of the Xastir images from here: VMWare Player Images (via Torrent)
- HowTo:Mac_OSX - install Xastir from source with GraphicsMagick, pcre/dbfawk, libproj and GeoTiff.
- Homebrew - Install Xastir using the Homebrew package management system for dependencies
- Fink - installing using Fink port tools (no detailed instructions listed here yet)
- Macports - install using Macports tools
- MacOSXpackage - install a precompiled binary
- MacOSXsource - build all support packages then xastir from source
- Notes:Mac OSX
Windows
- HowTo:VMware - Install in a Linux Virtual Machine under Windows (recommended)
- HowTo:VirtualBox - Install in a Linux Virtual Machine using VirtualBox
- HowTo:Windows - Install on Windows, using CYGWIN (not recommended)
- HowTo:Win10 - Install on Win10