summaryrefslogtreecommitdiffstats
path: root/download/index.html
blob: 35e7b67a8e10cd40ef55f30ba7da688c6000fdef (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
<!DOCTYPE html>
<html lang="en">
  <head>
    <script>
      if ((window.location.host == "stedolan.github.io") && (window.location.protocol != "https:"))
        window.location.protocol = "https";
    </script>
    <meta charset="utf-8">
    <title>Download jq</title>
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <link rel="canonical" href="https://stedolan.github.io/jq/download/" />
    <link href="https://maxcdn.bootstrapcdn.com/bootswatch/3.3.5/spacelab/bootstrap.min.css" rel="stylesheet" integrity="sha256-j7Dtnd7ZjexEiPNbscbopFn9+Cs0b3TLipKsWAPHZIM= sha512-RFhfi6P8zWMAJrEGU+CPjuxPh3r/UUBGqQ+/o6WKPIVZmQqeOipGotH2ihRULuQ8wsMBoK15TSZqc/7VYWyuIw==" crossorigin="anonymous">
    <link rel="stylesheet" href="/jq/css/base.css" type="text/css">
    <!--[if lt IE 9]>
      <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
      <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
    <![endif]-->
  </head>


  <body id="download">
    <div class="navbar navbar-default navbar-fixed-top" role="navigation">
      <div class="container">
        <div class="navbar-header">
          <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#nav-collapse">
            <span class="sr-only">Toggle navigation</span>
            <span class="icon-bar"></span>
            <span class="icon-bar"></span>
            <span class="icon-bar"></span>
          </button>
          <a class="navbar-brand" href="/jq/">jq</a>
        </div>

        <div class="navbar-collapse collapse" id="nav-collapse">
          <ul class="nav navbar-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="https://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 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.5 is in the official <a href="https://packages.debian.org/jq">Debian</a> and <a href="http://packages.ubuntu.com/jq">Ubuntu</a> repositories. Install using <code>sudo apt-get install jq</code>.</p>
</li>

<li>
<p>jq 1.5 is in the official <a href="http://pkgs.fedoraproject.org/cgit/jq.git/">Fedora</a> repository. Install using <code>sudo dnf install jq</code>.</p>
</li>

<li>
<p>jq 1.4 is in the official <a href="https://software.opensuse.org/package/jq">openSUSE</a> repository. Install using <code>sudo zypper install jq</code>.</p>
</li>

<li>
<p>For Arch users, a PKGBUILD is in the <a href="https://aur.archlinux.org/packages/jq-git/">AUR</a>. Refer to the <a href="https://wiki.archlinux.org/index.php/Arch_User_Repository">ArchWiki</a> for how to install from AUR.</p>
</li>

<li>
<p>jq 1.5 binaries for <a href="https://github.com/stedolan/jq/releases/download/jq-1.5/jq-linux64">64-bit</a> or <a href="https://github.com/stedolan/jq/releases/download/jq-1.5/jq-linux32">32-bit</a>.</p>
</li>

<li>
<p>jq 1.4 binaries for <a href="https://github.com/stedolan/jq/releases/download/jq-1.4/jq-linux-x86_64">64-bit</a> or <a href="https://github.com/stedolan/jq/releases/download/jq-1.4/jq-linux-x86">32-bit</a>.</p>
</li>

<li>
<p>jq 1.3 binaries for <a href="https://github.com/stedolan/jq/releases/download/jq-1.3/jq-linux-x86_64">64-bit</a> or <a href="https://github.com/stedolan/jq/releases/download/jq-1.3/jq-linux-x86">32-bit</a>.</p>
</li>
</ul>

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

<ul>
<li>
<p>Use <a href="http://brew.sh/">Homebrew</a> to install jq 1.5 with <code>brew install jq</code>.</p>
</li>

<li>
<p>jq 1.5 binary for <a href="https://github.com/stedolan/jq/releases/download/jq-1.5/jq-osx-amd64">64-bit</a>.</p>
</li>

<li>
<p>jq 1.4 binaries for <a href="https://github.com/stedolan/jq/releases/download/jq-1.4/jq-osx-x86_64">64-bit</a> or <a href="https://github.com/stedolan/jq/releases/download/jq-1.4/jq-osx-x86">32-bit</a>.</p>
</li>

<li>
<p>jq 1.3 binaries for <a href="https://github.com/stedolan/jq/releases/download/jq-1.3/jq-osx-x86_64">64-bit</a> or <a href="https://github.com/stedolan/jq/releases/download/jq-1.3/jq-osx-x86">32-bit</a>.</p>
</li>
</ul>

<h3 id="freebsd">FreeBSD</h3>

<ul>
<li>Use <a href="https://www.freshports.org/textproc/jq/">FreshPorts</a> to install jq 1.4 with <code>pkg install jq</code>.</li>
</ul>

<h3 id="solaris">Solaris</h3>

<ul>
<li>
<p><code>pkgutil -i jq</code> in <a href="https://www.opencsw.org/p/jq">OpenCSW</a> for Solaris 10+, Sparc and x86.</p>
</li>

<li>
<p>jq 1.4 binaries for Solaris 11 <a href="https://github.com/stedolan/jq/releases/download/jq-1.4/jq-solaris11-64">64-bit</a> or <a href="https://github.com/stedolan/jq/releases/download/jq-1.4/jq-solaris11-32">32-bit</a>.</p>
</li>
</ul>

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

<ul>
<li>
<p>Use <a href="https://chocolatey.org/">Chocolatey NuGet</a> to install jq 1.5 with <code>chocolatey install jq</code>.</p>
</li>

<li>
<p>jq 1.5 executables for <a href="https://github.com/stedolan/jq/releases/download/jq-1.5/jq-win64.exe">64-bit</a> or <a href="https://github.com/stedolan/jq/releases/download/jq-1.5/jq-win32.exe">32-bit</a>.</p>
</li>

<li>
<p>jq 1.4 executables for <a href="https://github.com/stedolan/jq/releases/download/jq-1.4/jq-win64.exe">64-bit</a> or <a href="https://github.com/stedolan/jq/releases/download/jq-1.4/jq-win32.exe">32-bit</a>.</p>
</li>

<li>
<p>jq 1.3 executables for <a href="https://github.com/stedolan/jq/releases/download/jq-1.3/jq-win64.exe">64-bit</a> or <a href="https://github.com/stedolan/jq/releases/download/jq-1.3/jq-win32.exe">32-bit</a>.</p>
</li>
</ul>

<h3 id="checksums_and_signatures">Checksums and signatures</h3>

<p>SHA-256 checksums are provided for all release and pre-release binaries. They can be found under <a href="https://github.com/stedolan/jq/tree/master/sig">sig/v1.x/sha256sum.txt</a>. The checksums for jq 1.5 are in <a href="https://raw.githubusercontent.com/stedolan/jq/master/sig/v1.5/sha256sum.txt">sig/v1.5/sha256sum.txt</a>.</p>

<p>Additionally, all binaries are signed by the <a href="https://raw.githubusercontent.com/stedolan/jq/master/sig/jq-release.key">jq Package Signing Key</a>. The signatures can be found under <a href="https://github.com/stedolan/jq/tree/master/sig">sig/v1.x/*.asc</a>. The signatures for jq 1.5 are in <a href="https://github.com/stedolan/jq/tree/master/sig/v1.5">sig/v1.5/*.asc</a>. You can use <a href="https://gnupg.org/">GnuPG</a> to verify a signature by downloading the signature and running <code>gpg --verify signature.asc</code>.</p>

<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="https://github.com/stedolan/jq/releases/download/jq-1.5/jq-1.5.tar.gz">Source tarball for jq 1.5</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’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 --disable-maintainer-mode
make
sudo make install</code></pre>

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

<ul>
<li><a href="https://gcc.gnu.org">GCC</a></li>

<li><a href="https://www.gnu.org/software/make/">Make</a></li>

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

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

<p>On OS X, these are all included in Apple’s command line tools, which can be installed from <a href="https://developer.apple.com/xcode/">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://brew.sh">Homebrew</a> or <a href="https://macports.org/">MacPorts</a>.</p>

<p>The <code>--disable-maintainer-mode</code> flag says to use the pre-generated lexer and parser that come with the code. To compile the lexer and parser also from source, leave out this flag. You will need to install <a href="http://flex.sourceforge.net/">Flex</a> and <a href="https://www.gnu.org/software/bison/">Bison</a>.</p>

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

<p>jq’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’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’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://getbootstrap.com">Bootstrap</a>, themed with <a href="https://bootswatch.com">Bootswatch</a>.</p>
        <p>jq is licensed under the MIT license (code) and the <a href="https://creativecommons.org/licenses/by/3.0/">CC-BY-3.0</a> license (docs).</p>
      </div>
    </footer>

    <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
    <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/js/bootstrap.min.js" integrity="sha256-Sk3nkD6mLTMOF0EOpNtsIry+s1CsaqQC1rVLTAy+0yc= sha512-K1qjQ+NcF2TYO/eI3M6v8EiNYZfA95pQumfvcVrTHtwQVDG+aHRqLi/ETn2uB+1JqwYqVG3LIvdm9lj6imS/pQ==" crossorigin="anonymous"></script>
    <script src="https://twitter.github.io/typeahead.js/releases/0.11.1/typeahead.bundle.js"></script>

  </body>
</html>