source: INSTALL.txt @ 98bfadb

Last change on this file since 98bfadb was 04785e2, checked in by kytv <kytv@…>, 9 years ago

document installing as a service

  • Property mode set to 100644
File size: 1.7 KB
Line 
1I2P source installation instructions
2
3Prerequisites to build from source:
4        Java SDK (preferably Oracle/Sun or OpenJDK) 1.6.0 or higher
5          Non-linux operating systems and JVMs: See http://trac.i2p2.de/wiki/java
6        Apache Ant 1.7.0 or higher
7        Optional, For multilanguage support: The xgettext, msgfmt, and msgmerge tools installed
8        from the GNU gettext package http://www.gnu.org/software/gettext/
9
10To build and install I2P from source, you must first build
11and package up the appropriate installer by running:
12
13  ant pkg
14
15
16This will produce a few key files:
17* install.jar:    the GUI and console installer
18* i2pinstall.exe: the GUI and console installer wrapped for cross-platform execution
19* i2pupdate.zip:  the update package
20
21From there, you can run the headless (console mode) installer:
22  java -jar i2pinstall.exe -console
23
24Or run the GUI installer:
25  java -jar i2pinstall.exe
26
27Or move the i2pupdate.zip file into an existing installation directory and restart.
28
29To start I2P:
30   (*nix): sh i2prouter start
31   (win*): I2P.exe or i2prouter.bat
32   (non-x86 platforms PPC, ARM, etc): sh runplain.sh
33
34To install I2P as a system service:
35   (*nix) sh i2prouter install
36   (win*) install_i2p_service_winnt.bat
37
38To uninstall I2P as a system service:
39   (*nix) sh i2prouter remove
40   (win*) uninstall_i2p-service_winnt.bat
41
42To stop I2P (gracefully):
43   lynx http://localhost:7657/summaryframe (click "Shutdown")
44
45To stop I2P immediately:
46   sh i2prouter stop
47
48To uninstall I2P:
49   rm -rf $I2PInstallDir ~/.i2p
50
51Supported JVMs:
52  Windows: Latest available from http://java.com/download (1.5+ supported)
53  Linux:   Latest available from http://java.com/download (1.5+ supported)
54  FreeBSD: 1.5-compatible (NIO required)
55  Other operating systems and JVMs: See http://trac.i2p2.de/wiki/java
Note: See TracBrowser for help on using the repository browser.