| 1 | I2P source installation instructions |
|---|
| 2 | |
|---|
| 3 | Prerequisites to build from source: |
|---|
| 4 | Java SDK (preferably Oracle/Sun or OpenJDK) 1.7.0 or higher |
|---|
| 5 | Non-linux operating systems and JVMs: See https://trac.i2p2.de/wiki/java |
|---|
| 6 | Certain subsystems for embedded (core, router, mstreaming, streaming, i2ptunnel) require only Java 1.6 |
|---|
| 7 | Apache Ant 1.7.0 or higher |
|---|
| 8 | The xgettext, msgfmt, and msgmerge tools installed |
|---|
| 9 | from the GNU gettext package http://www.gnu.org/software/gettext/ |
|---|
| 10 | Build environment must use a UTF-8 locale. |
|---|
| 11 | |
|---|
| 12 | To build and install I2P from source, you must first build |
|---|
| 13 | and package up the appropriate installer by running: |
|---|
| 14 | |
|---|
| 15 | ant pkg |
|---|
| 16 | |
|---|
| 17 | On non-x86, use one of the following instead: |
|---|
| 18 | ant installer-linux |
|---|
| 19 | ant installer-freebsd |
|---|
| 20 | ant installer-osx |
|---|
| 21 | |
|---|
| 22 | |
|---|
| 23 | |
|---|
| 24 | This will produce a few key files: |
|---|
| 25 | * install.jar: the GUI and console installer |
|---|
| 26 | * i2pinstall.exe: the GUI and console installer wrapped for cross-platform execution |
|---|
| 27 | (only created with ant pkg) |
|---|
| 28 | * i2pupdate.zip: the update package |
|---|
| 29 | (only created with ant pkg) |
|---|
| 30 | |
|---|
| 31 | From there, you can run the headless (console mode) installer: |
|---|
| 32 | java -jar i2pinstall.exe -console |
|---|
| 33 | or |
|---|
| 34 | java -jar i2pinstall.jar -console |
|---|
| 35 | |
|---|
| 36 | Or run the GUI installer: |
|---|
| 37 | java -jar i2pinstall.exe |
|---|
| 38 | or |
|---|
| 39 | java -jar i2pinstall.jar |
|---|
| 40 | or on Windows, just double-click on i2pinstall.exe. |
|---|
| 41 | |
|---|
| 42 | Or move the i2pupdate.zip file into an existing installation directory and restart. |
|---|
| 43 | |
|---|
| 44 | To start I2P: |
|---|
| 45 | (*nix, BSD, Mac): sh i2prouter start |
|---|
| 46 | (win*): I2P.exe or i2prouter.bat |
|---|
| 47 | (platforms without wrapper support): sh runplain.sh |
|---|
| 48 | |
|---|
| 49 | To install I2P as a system service: |
|---|
| 50 | (*nix, BSD, Mac) sh i2prouter install |
|---|
| 51 | (win*) install_i2p_service_winnt.bat |
|---|
| 52 | |
|---|
| 53 | To uninstall I2P as a system service: |
|---|
| 54 | (*nix, BSD, Mac) sh i2prouter remove |
|---|
| 55 | (win*) uninstall_i2p-service_winnt.bat |
|---|
| 56 | |
|---|
| 57 | To stop I2P (gracefully): |
|---|
| 58 | lynx http://localhost:7657/summaryframe (click "Shutdown") |
|---|
| 59 | or (*nix, BSD, Mac) sh i2prouter graceful |
|---|
| 60 | |
|---|
| 61 | To stop I2P immediately: |
|---|
| 62 | (*nix, BSD, Mac) sh i2prouter stop |
|---|
| 63 | |
|---|
| 64 | To uninstall I2P: |
|---|
| 65 | rm -rf $I2PInstallDir ~/.i2p |
|---|
| 66 | |
|---|
| 67 | Supported JVMs: |
|---|
| 68 | Windows: Latest available from http://java.com/download (1.7+ supported) |
|---|
| 69 | Linux: Latest available from http://java.com/download (1.7+ supported) |
|---|
| 70 | FreeBSD: 1.7-compatible (NIO required) |
|---|
| 71 | Other operating systems and JVMs: See http://trac.i2p2.de/wiki/java |
|---|
