source: INSTALL.txt @ 16549aa

Last change on this file since 16549aa was 16549aa, checked in by zzz <zzz@…>, 5 years ago

Update text docs for Java 7

  • Property mode set to 100644
File size: 2.2 KB
Line 
1I2P source installation instructions
2
3Prerequisites 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
11To build and install I2P from source, you must first build
12and package up the appropriate installer by running:
13
14        ant pkg
15
16On non-x86, use one of the following instead:
17        ant installer-linux
18        ant installer-freebsd
19        ant installer-osx
20
21
22
23This will produce a few key files:
24* install.jar:    the GUI and console installer
25* i2pinstall.exe: the GUI and console installer wrapped for cross-platform execution
26                  (only created with ant pkg)
27* i2pupdate.zip:  the update package
28                  (only created with ant pkg)
29
30From there, you can run the headless (console mode) installer:
31  java -jar i2pinstall.exe -console
32or
33  java -jar i2pinstall.jar -console
34
35Or run the GUI installer:
36  java -jar i2pinstall.exe
37or
38  java -jar i2pinstall.jar
39or on Windows, just double-click on i2pinstall.exe.
40
41Or move the i2pupdate.zip file into an existing installation directory and restart.
42
43To start I2P:
44   (*nix, BSD, Mac): sh i2prouter start
45   (win*): I2P.exe or i2prouter.bat
46   (platforms without wrapper support): sh runplain.sh
47
48To install I2P as a system service:
49   (*nix, BSD, Mac) sh i2prouter install
50   (win*) install_i2p_service_winnt.bat
51
52To uninstall I2P as a system service:
53   (*nix, BSD, Mac) sh i2prouter remove
54   (win*) uninstall_i2p-service_winnt.bat
55
56To stop I2P (gracefully):
57   lynx http://localhost:7657/summaryframe (click "Shutdown")
58   or (*nix, BSD, Mac) sh i2prouter graceful
59
60To stop I2P immediately:
61   (*nix, BSD, Mac) sh i2prouter stop
62
63To uninstall I2P:
64   rm -rf $I2PInstallDir ~/.i2p
65
66Supported JVMs:
67  Windows: Latest available from http://java.com/download (1.7+ supported)
68  Linux:   Latest available from http://java.com/download (1.7+ supported)
69  FreeBSD: 1.7-compatible (NIO required)
70  Other operating systems and JVMs: See http://trac.i2p2.de/wiki/java
Note: See TracBrowser for help on using the repository browser.