A hint: This file contains one or more very long lines, so maybe it is better readable using the pure text view mode that shows the contents as wrapped lines within the browser window.
1 <!-- vim: set syn=markdown : --> 2 <!-- 3 Licensed to the Apache Software Foundation (ASF) under one or more 4 contributor license agreements. See the NOTICE file distributed with 5 this work for additional information regarding copyright ownership. 6 The ASF licenses this file to You under the Apache License, Version 2.0 7 (the "License"); you may not use this file except in compliance with 8 the License. You may obtain a copy of the License at 9 10 http://www.apache.org/licenses/LICENSE-2.0 11 12 Unless required by applicable law or agreed to in writing, software 13 distributed under the License is distributed on an "AS IS" BASIS, 14 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 15 See the License for the specific language governing permissions and 16 limitations under the License. 17 --> 18 #set($h1='#') 19 #set($h2='##') 20 21 $h1 Download Apache Log4j 2 22 23 Apache Log4j 2 is distributed under the [Apache License, version 2.0](https://www.apache.org/licenses/LICENSE-2.0.html). 24 25 The link in the Mirrors column should display a list of available mirrors with a default selection based on your 26 inferred location. If you do not see that page, try a different browser. The checksum and signature are links to 27 the originals on the main distribution server. 28 29 | Distribution | Mirrors | Checksum | Signature | 30 | ------------------------------ | -------------------------------------------------------- | --------------------------------------------------------------- | --------------------------------------------------------------- | 31 | Apache Log4j 2 binary (tar.gz) | [apache-log4j-${Log4jReleaseVersion}-bin.tar.gz][bintar] | [apache-log4j-${Log4jReleaseVersion}-bin.tar.gz.sha512][bintarsha512] | [apache-log4j-${Log4jReleaseVersion}-bin.tar.gz.asc][bintarasc] | 32 | Apache Log4j 2 binary (zip) | [apache-log4j-${Log4jReleaseVersion}-bin.zip][binzip] | [apache-log4j-${Log4jReleaseVersion}-bin.zip.sha512][binzipsha512] | [apache-log4j-${Log4jReleaseVersion}-bin.zip.asc][binzipasc] | 33 | Apache Log4j 2 source (tar.gz) | [apache-log4j-${Log4jReleaseVersion}-src.tar.gz][srctar] | [apache-log4j-${Log4jReleaseVersion}-src.tar.gz.sha512][srctarsha512] | [apache-log4j-${Log4jReleaseVersion}-src.tar.gz.asc][srctarasc] | 34 | Apache Log4j 2 source (zip) | [apache-log4j-${Log4jReleaseVersion}-src.zip][srczip] | [apache-log4j-${Log4jReleaseVersion}-src.zip.sha512][srczipsha512] | [apache-log4j-${Log4jReleaseVersion}-src.zip.asc][srczipasc] | 35 36 [bintar]: https://www.apache.org/dyn/closer.lua/logging/log4j/${Log4jReleaseVersion}/apache-log4j-${Log4jReleaseVersion}-bin.tar.gz 37 [bintarsha512]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersion}/apache-log4j-${Log4jReleaseVersion}-bin.tar.gz.sha512 38 [bintarasc]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersion}/apache-log4j-${Log4jReleaseVersion}-bin.tar.gz.asc 39 [binzip]: https://www.apache.org/dyn/closer.lua/logging/log4j/${Log4jReleaseVersion}/apache-log4j-${Log4jReleaseVersion}-bin.zip 40 [binzipsha512]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersion}/apache-log4j-${Log4jReleaseVersion}-bin.zip.sha512 41 [binzipasc]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersion}/apache-log4j-${Log4jReleaseVersion}-bin.zip.asc 42 [srctar]: https://www.apache.org/dyn/closer.lua/logging/log4j/${Log4jReleaseVersion}/apache-log4j-${Log4jReleaseVersion}-src.tar.gz 43 [srctarsha512]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersion}/apache-log4j-${Log4jReleaseVersion}-src.tar.gz.sha512 44 [srctarasc]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersion}/apache-log4j-${Log4jReleaseVersion}-src.tar.gz.asc 45 [srczip]: https://www.apache.org/dyn/closer.lua/logging/log4j/${Log4jReleaseVersion}/apache-log4j-${Log4jReleaseVersion}-src.zip 46 [srczipsha512]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersion}/apache-log4j-${Log4jReleaseVersion}-src.zip.sha512 47 [srczipasc]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersion}/apache-log4j-${Log4jReleaseVersion}-src.zip.asc 48 49 It is essential that you verify the integrity of the downloaded files using the PGP and SHA512 signatures. 50 Please read [Verifying Apache HTTP Server Releases](https://httpd.apache.org/dev/verification.html) for more 51 information on why you should verify our releases. 52 53 The PGP signatures can be verified using PGP or GPG. First download the 54 [KEYS](https://www.apache.org/dist/logging/KEYS) as well as the asc signature file for the relevant distribution. 55 Make sure you get these files from the [main distribution directory](https://www.apache.org/dist/logging/), rather 56 than from a mirror. Then verify the signatures using 57 58 gpg --import KEYS 59 gpg --verify apache-log4j-${Log4jReleaseVersion}-bin.tar.gz.asc 60 61 Apache Log4j ${Log4jReleaseVersion} is signed by ${Log4jReleaseManager} (${Log4jReleaseKey}) 62 63 Alternatively, you can verify the SHA512 signature on the files. A unix program called sha or sha512sum is included 64 in many unix distributions. 65 66 $h2 Previous Releases 67 68 Log4j ${Log4jReleaseVersionJava6} was the last 2.x release to support Java 6. Those artifacts can be found at: 69 70 | Distribution | Mirrors | Checksum | Signature | 71 | ------------------------------ | ------------------------------------------ | ------------------------------------------------- | ------------------------------------------------- | 72 | Apache Log4j 2 binary (tar.gz) | [apache-log4j-${Log4jReleaseVersionJava6}-bin.tar.gz][bintar-jdk6] | [apache-log4j-${Log4jReleaseVersionJava6}-bin.tar.gz.sha512][bintarsha512-jdk6] | [apache-log4j-${Log4jReleaseVersionJava6}-bin.tar.gz.asc][bintarasc-jdk6] | 73 | Apache Log4j 2 binary (zip) | [apache-log4j-${Log4jReleaseVersionJava6}-bin.zip][binzip-jdk6] | [apache-log4j-${Log4jReleaseVersionJava6}-bin.zip.sha512][binzipsha512-jdk6] | [apache-log4j-${Log4jReleaseVersionJava6}-bin.zip.asc][binzipasc-jdk6] | 74 | Apache Log4j 2 source (tar.gz) | [apache-log4j-${Log4jReleaseVersionJava6}-src.tar.gz][srctar-jdk6] | [apache-log4j-${Log4jReleaseVersionJava6}-src.tar.gz.sha512][srctarsha512-jdk6] | [apache-log4j-${Log4jReleaseVersionJava6}-src.tar.gz.asc][srctarasc-jdk6] | 75 | Apache Log4j 2 source (zip) | [apache-log4j-${Log4jReleaseVersionJava6}-src.zip][srczip-jdk6] | [apache-log4j-${Log4jReleaseVersionJava6}-src.zip.sha512][srczipsha512-jdk6] | [apache-log4j-${Log4jReleaseVersionJava6}-src.zip.asc][srczipasc-jdk6] | 76 77 [bintar-jdk6]: https://www.apache.org/dyn/closer.lua/logging/log4j/${Log4jReleaseVersionJava6}/apache-log4j-${Log4jReleaseVersionJava6}-bin.tar.gz 78 [bintarsha512-jdk6]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersionJava6}/apache-log4j-${Log4jReleaseVersionJava6}-bin.tar.gz.sha512 79 [bintarasc-jdk6]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersionJava6}/apache-log4j-${Log4jReleaseVersionJava6}-bin.tar.gz.asc 80 [binzip-jdk6]: https://www.apache.org/dyn/closer.lua/logging/log4j/${Log4jReleaseVersionJava6}/apache-log4j-${Log4jReleaseVersionJava6}-bin.zip 81 [binzipsha512-jdk6]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersionJava6}/apache-log4j-${Log4jReleaseVersionJava6}-bin.zip.sha512 82 [binzipasc-jdk6]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersionJava6}/apache-log4j-${Log4jReleaseVersionJava6}-bin.zip.asc 83 [srctar-jdk6]: https://www.apache.org/dyn/closer.lua/logging/log4j/${Log4jReleaseVersionJava6}/apache-log4j-${Log4jReleaseVersionJava6}-src.tar.gz 84 [srctarsha512-jdk6]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersionJava6}/apache-log4j-${Log4jReleaseVersionJava6}-src.tar.gz.sha512 85 [srctarasc-jdk6]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersionJava6}/apache-log4j-${Log4jReleaseVersionJava6}-src.tar.gz.asc 86 [srczip-jdk6]: https://www.apache.org/dyn/closer.lua/logging/log4j/${Log4jReleaseVersionJava6}/apache-log4j-${Log4jReleaseVersionJava6}-src.zip 87 [srczipsha512-jdk6]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersionJava6}/apache-log4j-${Log4jReleaseVersionJava6}-src.zip.sha512 88 [srczipasc-jdk6]: https://www.apache.org/dist/logging/log4j/${Log4jReleaseVersionJava6}/apache-log4j-${Log4jReleaseVersionJava6}-src.zip.asc 89 90 All previous releases of Apache log4j can be found in the 91 [archive repository](https://archive.apache.org/dist/logging/log4j/). 92 93 $h2 Using Log4j on your classpath 94 95 To use Log4j 2 in your application make sure that both the API and Core jars are in the application's classpath. Add 96 the dependencies listed below to your classpath. 97 98 log4j-api-${Log4jReleaseVersion}.jar 99 log4j-core-${Log4jReleaseVersion}.jar 100 101 You can do this from the command line or a manifest file.