177 lines
8.7 KiB
HTML
177 lines
8.7 KiB
HTML
{% extends "global/layout.html" %}
|
|
{% block title %}Apple MacOS{% endblock %}
|
|
{% block accuratefor %}0.9.47{% endblock %}
|
|
{% block content %}
|
|
<h1>{{ _('Separately Installing I2P and its dependencies on MacOS(The Long Way)') }}</h1>
|
|
|
|
<p>{% trans -%}
|
|
This is a detailed, step-by-step guide to installing and configuring I2P, including all dependencies and setting up a browser, on a new MacOS system.
|
|
Many users will be able to skip steps if they already have Java 8 or Firefox installed.{%- endtrans %}</p>
|
|
|
|
<h2>{{ _('So what are we going to do here?') }}</h2>
|
|
|
|
<p>{% trans -%}We're going to finish four tasks. We are going to:{%- endtrans %}</p>
|
|
|
|
<ol>
|
|
<li><a href="#part-one-install-java">{% trans -%}Install Java{%- endtrans %}</a></li>
|
|
<li><a href="#part-two-install-i2p">{% trans -%}Install I2P{%- endtrans %}</a></li>
|
|
<li><a href="#part-three-configure-i2p-app">{% trans -%}Configure I2P App{%- endtrans %}</a></li>
|
|
<li><a href="#part-four-configure-i2p-bandwidth">{% trans -%}Configure I2P Bandwidth{%- endtrans %}</a></li>
|
|
</ol>
|
|
|
|
<h3 id="part-one-install-java">{{ _('Part One: Install Java') }}</h3>
|
|
|
|
<p>{% trans -%}
|
|
In order to use I2P, you will need a suitable Java environment.
|
|
This guide uses Oracle's Java 8 implementation.
|
|
Please install it by following the instructions below:
|
|
{%- endtrans %}</p>
|
|
|
|
<p>{% trans -%}If you already have Java installed, you may{%- endtrans %} <a href="#part-two-install-i2p">Skip This Step</a></p>
|
|
|
|
<ol>
|
|
<li>{% trans -%}Begin by downloading Java, for example, {%- endtrans %} <a href="https://java.com/en/download/">using this version from Oracle</a>.
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/0-jre.png" alt="You need Oracle Java for MacOS" title="" /></li>
|
|
<li><img src="/_static/images/macos/1-jre.png" alt="You need Oracle Java for MacOS" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}Double-click the installer you just downloaded and allow the installer permission to proceed.{%- endtrans %}:
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/2-jre.png" alt="Give the installer permission to proceed" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}Accept the License terms.{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/3-jre.png" alt="Start installing Java" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}Java will show you some information about what it is and where it runs while you wait for it to finish installing.{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/4-jre.png" alt="Wait for the installer" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}When Java is done installing, it will look like this.{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/5-jre.png" alt="Step one complete" title="" /></li>
|
|
</ul></li>
|
|
</ol>
|
|
|
|
<h3 id="part-two-install-i2p">{{ _('Part Two: Download and Install I2P from a .jar file') }}</h3>
|
|
|
|
<ol>
|
|
<li>{% trans -%}Download I2P for Unix from{%- endtrans %} <a href="https://geti2p.net/en/download#unix">https://geti2p.net</a>.
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/0-i2p.png" alt="Download I2P" title="" /></li>
|
|
<li><img src="/_static/images/macos/1-i2p.png" alt="Select your Language" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}
|
|
Because I2P is being installed from a .jar file, it cannot be signed by an Apple certificate.
|
|
You will need to allow it special permission to install.
|
|
Even though the installer is unsigned, the updates are signed end-to-end by I2P.
|
|
{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/2-i2p.png" alt="Introduction" title="" /></li>
|
|
<li><img src="/_static/images/macos/3-i2p.png" alt="Exception" title="" /></li>
|
|
<li><img src="/_static/images/macos/4-i2p.png" alt="Profit" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}Select a language you are familiar with.{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/5-i2p.png" alt="Select Components" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}
|
|
Now the installer is ready to start.
|
|
Click next to advance.
|
|
{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/6-i2p.png" alt="Start installing" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}
|
|
Accept the license.
|
|
I2P is Free Software, mostly in the public domain with limited use of GPL2, Creative Commons, and other Free and Open-Source Licenses.
|
|
{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/7-i2p.png" alt="Accept the License Agreement(or mostly lack thereof)" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}
|
|
Install the I2P router and base config.
|
|
It is recommended that you keep the install directory the default.
|
|
{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/8-i2p.png" alt="Install the files" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}
|
|
I2P is now installed!
|
|
The remaining installer pages explain some aspects of running I2P on OSX.
|
|
{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/9-i2p.png" alt="Finish it up" title="" /></li>
|
|
<li><img src="/_static/images/macos/10-i2p.png" alt="Finish it up" title="" /></li>
|
|
<li><img src="/_static/images/macos/11-i2p.png" alt="Finish it up" title="" /></li>
|
|
</ul></li>
|
|
</ol>
|
|
|
|
<h3 id="part-three-configure-i2p-app">{{ _('Part Three: Configure I2P App') }}</h3>
|
|
|
|
<ol>
|
|
<li>{% trans -%}
|
|
For convenience, you may want to create a shortcut to launch the I2P router.
|
|
Find the "i2p" directory in the "Applications" directory using Finder.
|
|
{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/0-conf.png" alt="Open the Applications dir" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}Open the folder and find the Start Router Icon shown.{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/1-conf.png" alt="Find the launcher" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}Click the icon to start the I2P router - it will show up in your dock as shown and you can choose too keep it there.{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/2-conf.png" alt="Add it to the launch bar" title="" /></li>
|
|
</ul></li>
|
|
</ol>
|
|
|
|
<h3 id="part-four-configure-i2p-bandwidth">{{ _('Part Four: Configure I2P Bandwidth') }}</h3>
|
|
|
|
<ol>
|
|
<li>{% trans -%}
|
|
When you visit the I2P router console for the first time, it will automatically direct you to the configuration wizard.
|
|
Start by selecting a language for the I2P interface.
|
|
{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/0-wiz.png" alt="Start the bandwidth wizard" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}Next, pick either a dark or light theme.{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/1-wiz.png" alt="Let the participant know what the bandwidth test entails" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}
|
|
The next step is the bandwidth test.
|
|
The bandwidth test takes a minute to run completely.
|
|
During the bandwidth test, we'll need to connect to the external M-Lab Service, which makes a direct connection to a remote server(Operated by Measurement Lab) to measure your internet speed.
|
|
{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/2-wiz.png" alt="Run the bandwidth test" title="" /></li>
|
|
<li><img src="/_static/images/macos/3-wiz.png" alt="Start the bandwidth wizard" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}
|
|
Confirm the bandwidth measurement and adjust your share percentage.
|
|
{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/4-wiz.png" alt="Let the participant know what the bandwidth test entails" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}Confirm your bandwidth settings and adjust how much of your bandwidth you wish to share.{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/5-wiz.png" alt="Run the bandwidth test" title="" /></li>
|
|
</ul></li>
|
|
<li>{% trans -%}You're finished! I2P is now configured.{%- endtrans %}
|
|
<ul style="list-style-type: none;">
|
|
<li><img src="/_static/images/macos/6-wiz.png" alt="Run the bandwidth test" title="" /></li>
|
|
</ul></li>
|
|
</ol>
|
|
|
|
<p>{% trans -%}If you want to re-run the welcome wizard after completing it, you can visit the page
|
|
on{%- endtrans %} <a href="http://localhost:7657/welcome">your router console</a>.</p>
|
|
|
|
<p>{% trans -%}That's it! You're now ready to use I2P. You can browse I2P Sites, download files, host services,
|
|
e-mail and chat anonymously. Visit the <a href="https://localhost:7657/home">router console homepage</a> to
|
|
get started.{%- endtrans %}</p>
|
|
|
|
{% endblock %}
|