Welcome to your eepsite

This is your eepsite - simply edit the files under ./eepsite/docroot/ and they'll be reachable by others once you follow the instructions below. In I2P, eepsites are addressed using a 'key', which is represented as a really long Base64 string. (The 'key' is somewhat analogous to an IP address, and is shown on the eepsite's I2PTunnel configuration page). The instructions below detail how to assign a name like "mysite.i2p" to your key and start up your eepsite.

You can also reach your eepsite locally through http://localhost:7658/. If you want to change the port number, edit the file ./eepsite/jetty.xml and update the I2PTunnel configuration accordingly.

Step-by-step instructions for starting your new eepsite and announcing it to the I2P community

• Pick a name for your eepsite (something.i2p). Use all lower-case. You may wish to check first in your own router's address book here, or the file i2p/hosts.txt to see if your name is already taken. Enter the new name for your eepsite on the eepsite i2ptunnel configuration page where it says "Website name". This will replace the default "mysite.i2p". Also, check the "Auto Start" box. Your eepsite will now start every time you start your router. Be sure and click "Save".
• Click the start button for your eepsite on the main i2ptunnel configuration page. You should now see "eepsite" listed under "Local Destinations" on the left side of the I2P Router Console. Your eepsite is now running.
• Highlight the entire "Local destination" key on the eepsite i2ptunnel configuration page. and copy it for later pasting. Make sure you get the whole thing - it's over 500 characters and it must end in "AAAA".
• Enter the name and paste in the destination key into your master address book. Click "Add" to add the destination to your address book.
• In your browser, enter in your eepsite name (something.i2p) and you should be right back here. Hopefully it worked.
• Before you tell the world about your new eepsite, you should add some content. Go to i2p/eepsite/docroot and copy this document (index.html) to help.html so you can refer to it later. Now edit index.html and add content, pictures, and whatever you would like to share.
• Now it's time to add your eepsite to I2P's most popular address book. To do that, you must to tell orion.i2p what your eepsite name and key are. Orion has a web interface where you can add a key to the address book. The key entry form is here. Again, your key is the entire "Local destination" key on the eepsite i2ptunnel configuration page. Be sure you get the whole thing, ending with "AAAA". Don't forget to click "add a key". Check to see if it reports the key was added. Since most routers periodically get address book updates from orion, within several hours others will be able to find your website by simply typing something.i2p into their browser.
• If you are in a hurry and can't wait a few hours, you can tell people to use orion's "jump" address helper redirection service. This will work within a few minutes of your entering the key to orion.i2p. Test it yourself first by entering http://orion.i2p/jump/something.i2p into your browser. Once it's working, then you can tell others to use it.
• Some people check orion.i2p/list/ for new eepsites, so you may start getting a few visitors. But there are plenty of other ways to tell people. Here are a few ideas:
  • Post a message on the Eepsite announce forum on forum.i2p.
  • Tell people about it on the #i2p or #i2p-chat channels on IRC.
  • Put it in a new post on the new Syndie.
  • Put it in Ugha's Eepsite Index Wiki
  Note that some sites recommend pasting in that really long destination key. You can if you want - but if you have successfully posted your key on the orion page here, tested it using http://orion.i2p/jump/something.i2p, and waited 24 hours for orion's address book to propagate to others, that shouldn't be necessary.
• If you have any questions try IRC #i2p or the technical problems section on forum.i2p. Good luck and welcome to I2P!