The issue described on this page only affects Windows systems that originally installed I2P with version 0.9.5. Other operating systems are not affected.

This issue has been corrected as of the 0.9.5-win1 release.

Background

A change was introduced during the 0.9.5 cycle to allow I2P's configuration files to be edited with the standard Windows text editor, Notepad. This change had the unfortunate side-effect of causing our eepsite migration code to fail to run on Windows systems, leading to eepsites being served from the installation directory. Consequently:

  • depending upon how I2P is started, the eepsite may not be accessible; and
  • confusion ensues—all documentation states that eepsites are served from the profile path; and
  • the update to Jetty 7, included in the 0.9.6 release, will fail.

While no action is required for users that are not hosting an eepsite (or are not using the included Jetty to host an eepsite), it is recommended to follow this procedure to avoid issues in case you decide to run a Jetty-hosted eepsite in the future. If you are running an eepsite it is important to follow this procedure prior to upgrading to 0.9.6.

Tickets 919 & 920 correspond to this issue.

Fixing the configuration

Because this issue causes the migration code to not run, the path in %APPDATA%\I2P\clients.config isn't updated to use an absolute path for the Jetty config file, requiring the path to be set manually. Experienced users can set the correct path in clients.config directly and restart I2P, but this page will explain how to correct the problem from within the router console.

  1. From the Home page of the I2P Router Console, click the I2P logo in the upper-left corner.
  2. Click the I2P Services link. You should see something like the following: If the path at number 1 in the image above is set to eepsite/jetty.xml, the path needs to be updated.
  3. Click the Edit button next to I2P webserver (eepsite). The page will reload to allow the path to be edited as shown below: Insert the full path to your I2P configuration directory before the text "eepsite/jetty.xml" as shown above, then click Click the Save Client Configuration button.
  4. If you're hosting an eepsite, move its contents to its proper home at %APPDATA%\I2P\eepsite\docroot.
  5. At this point you should restart your I2P router.

After following the steps outlined above, your eepsite will be served from %APPDATA%\I2P\eepsite\docroot and should be accessible at http://127.0.0.1:7658.