jq/download/index.html

<!DOCTYPE html>
<html lang="en">
  <head>
  <meta charset=UTF-8>
  <title>Download jq</title>
  <link rel="stylesheet" href="/jq/bootstrap/css/bootstrap.css" type="text/css">
  <link rel="stylesheet" href="/jq/css/base.css" type="text/css">
  <!--[if IE]>
    <script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script>
  <![endif]-->
  <script src="//ajax.googleapis.com/ajax/libs/jquery/1.8.1/jquery.min.js"></script>
  <script src="/jq/bootstrap/js/bootstrap.js"></script>

</head>
  <body id="download">
    
<div class="navbar navbar-inverse navbar-fixed-top">
  <div class="navbar-inner">
    <div class="container">
      <button type="button" class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse">
        <span class="icon-bar"></span>
        <span class="icon-bar"></span>
        <span class="icon-bar"></span>
      </button>
      <a class="brand" href="/jq/">jq</a>
      <div class="nav-collapse collapse">
        <ul class="nav">
          
            <li >
              <a href="/jq/tutorial/">Tutorial</a>
            </li>
          
            <li  class="active" >
              <a href="/jq/download/">Download</a>
            </li>
          
            <li >
              <a href="/jq/manual/">Manual</a>
            </li>
          
          <li><a href="https://github.com/stedolan/jq/issues">Issues</a></li>
          <li><a href="https://github.com/stedolan/jq">Source</a></li>
          <li><a href="http://jqplay.org">Try online!</a></li>
          <li><a href="https://raw.githubusercontent.com/stedolan/jq/master/NEWS">NEWS</a></li>
        </ul>
      </div>
    </div>
  </div>
</div>
	
    
    <div class="container">
        
      <div class="row">
        <h1>Download jq</h1>
        
          
            <p>jq is written in C and has no runtime dependencies, so it should be possible to build it for nearly any platform. Prebuilt binaries are available for Linux, OS X and Windows.</p>

<p>The binaries should just run, but on OS X and Linux you may need to make them executable first using <code>chmod +x jq</code>.</p>

<p>jq is licensed under the MIT license. For all of the gory details, read the file <code>COPYING</code> in the source distribution.</p>

<h3 id='linux'>Linux</h3>

<ul>
<li>
<p>jq 1.4 binaries for <a href='linux64/jq'>64-bit</a> or <a href='linux32/jq'>32-bit</a> systems.</p>
</li>

<li>
<p>jq 1.3 binaries for <a href='linux64/jq-1.3/jq'>64-bit</a> or <a href='linux32/jq-1.3/jq'>32-bit</a> systems.</p>
</li>

<li>
<p>For Arch users, a PKGBUILD for jq-1.1 is in the <a href='https://aur.archlinux.org/packages.php?ID=63849'>AUR</a>, as well as a PKGBUILD for the HEAD of master (<a href='https://aur.archlinux.org/packages.php?ID=63850'>jq-git</a>). You can install them using <a href='https://wiki.archlinux.org/index.php/Yaourt'>Yaourt</a> or manually by following instructions on <a href='https://wiki.archlinux.org/index.php/Arch_UseRepository'>Arch Linux&#8217;s Wiki</a>.</p>
</li>

<li>
<p>jq 1.4 is <a href='http://packages.debian.org/jq'>in Debian</a></p>
</li>
</ul>

<h3 id='os_x'>OS X</h3>

<ul>
<li>
<p><code>brew install jq</code> using <a href='http://mxcl.github.com/homebrew/'>homebrew</a></p>
</li>

<li>
<p>Or, grab prebuilt jq 1.4 <a href='osx64/jq'>64-bit binaries</a> or <a href='osx32/jq'>32-bit binaries</a></p>
</li>

<li>
<p>Or, grab prebuilt jq 1.3 <a href='osx64/jq-1.3/jq'>64-bit binaries</a> or <a href='osx32/jq-1.3/jq'>32-bit binaries</a></p>
</li>
</ul>

<h3 id='solaris_11'>Solaris 11</h3>

<ul>
<li>jq 1.4 executables for <a href='solaris11-64/jq.exe'>64-bit</a> or <a href='solaris11-32/jq.exe'>32-bit</a></li>
</ul>

<h3 id='windows'>Windows</h3>

<ul>
<li>jq 1.4 executables for <a href='win64/jq.exe'>64-bit</a> or <a href='win32/jq.exe'>32-bit</a></li>

<li>jq 1.3 executables for <a href='win64/jq-1.3/jq.exe'>64-bit</a> or <a href='win32/jq-1.3/jq.exe'>32-bit</a></li>
</ul>

<h3 id='from_source_on_linux_os_x_cygwin_and_other_posixlike_operating_systems'>From source on Linux, OS X, Cygwin, and other POSIX-like operating systems</h3>

<ul>
<li><a href='source/jq-1.4.tar.gz'>Source tarball for jq 1.4</a></li>
</ul>

<p>You can build it using the usual <code>./configure &amp;&amp; make &amp;&amp; sudo
make install</code> rigmarole.</p>

<p>If you&#8217;re interested in using the lastest development version, try:</p>

<pre><code>git clone https://github.com/stedolan/jq.git
cd jq
autoreconf -i
./configure
make
sudo make install</code></pre>

<p>To build it from a git clone, you&#8217;ll need to install a few packages first:</p>

<ul>
<li><a href='http://www.gnu.org/software/flex/'>Flex</a></li>

<li><a href='http://www.gnu.org/software/bison/'>Bison</a></li>

<li><a href='http://gcc.gnu.org'>GCC</a></li>

<li><a href='http://www.gnu.org/software/make'>Make</a></li>

<li><a href='http://www.gnu.org/software/automake'>Autotools</a></li>
</ul>

<p>For Linux systems, these will all be in your system&#8217;s package manager, and if you do development on the machine they&#8217;re most likely already installed.</p>

<p>On OS X, these are all included in Apple&#8217;s command line tools, which can be installed from <a href='http://developer.apple.com/technologies/tools/'>Xcode</a>. However, you may find that you need a newer version of Bison than the one provided by Apple. This can be found in <a href='http://mxcl.github.com/homebrew/'>Homebrew</a> or <a href='http://macports.org/'>MacPorts</a>.</p>

<p><code>flex</code> and <code>bison</code> are used to generate the lexer and parser for jq, and some python scripts generate the UTF8 encoding tables needed for JSON parsing.</p>

<h4 id='building_the_documentation'>Building the documentation</h4>

<p>jq&#8217;s documentation is compiled into static HTML using <a href='http://www.tinytree.info'>Bonsai</a>. To view the documentation locally, run <code>rake serve</code> (or <code>bundle exec rake serve</code>) from the docs/ subdirectory. To build the docs just <code>rake build</code> from the docs subdirectory. You&#8217;ll need a few Ruby dependencies, which can be installed by following the instructions in <code>docs/README.md</code>.</p>

<p>The man page is built by <code>make jq.1</code>, or just <code>make</code>, also from the YAML docs, and you&#8217;ll still need the Ruby dependencies to build the manpage.</p>
          
        
          
        
      </div>
    </div>
    <footer>
  <div class="container">
    <p>This website is made with <a href='http://www.tinytree.info'>Bonsai</a> and <a href='http://twitter.github.com/bootstrap/'>Twitter Bootstrap</a>, themed with <a href='http://bootswatch.com'>Bootswatch</a>.</p>

<p>jq is licensed under the MIT license (code) and the <a href='http://creativecommons.org/licenses/by/3.0/'>CC-BY-3.0</a> license (docs).</p>
  </div>
</footer>

    
  </body>
</html>