i2p.www/i2p2www/pages/downloads/mac.html

{% extends "global/layout.html" %}
{%- from "downloads/macros" import package_outer with context -%}
{% block title %}Mac OS X Easy Install Bundle{% endblock %}
{% block content %}

<h1>{{ _('Mac OS Easy Install Bundle') }}</h1>
<p>{% trans -%}
We are excited to offer you a DMG-based bundle for Mac OS.  It installs and behaves
the same way many other Mac OS applications do and does not require a Java
Runtime Environment to be available.
{%- endtrans %}</p>
<h2>{{ _('How do I use it?') }}</h2>
<p>{% trans -%}
Double-Click on the .dmg file, which you may download from this page. When a
window appears with the I2P application inside it, "drag" the application to the
"Applications" side of the window to install it. Once you're finished, I2P is
installed and can be launched from Finder. This procedure is the same as any
other Mac application. When you launch I2P, the I2P icon will appear on the Dock
and a few seconds later a browser will open with the I2P console page, inviting
you to complete the bandwidth setup wizard.
{%- endtrans %}</p>
<p>{% trans browser="https://geti2p.net/htproxyports" -%}
If you want to browse hidden websites ('eepsites') on the I2P network, you need
to configure your browser. Instructions for configuring a range of browsers are
available on <a href="{{ browser }}">the browser configuration
page</a>.
{%- endtrans %}</p>
<h2>{{ _('Why should I use it?') }}</h2>
<p>{% trans -%}
Two important reasons, 1) because this package is a .dmg, it can be signed with
a certificate which will be recognized by your computer. This means that your
computer can automatically make sure that you've obtained I2P from the I2P
Project, rather than a potentially altered or "fake" installer, and 2) because
it makes I2P easier to install and work with on Apple computers by using tools
that are familiar and built-into the operating system.
{%- endtrans %}</p>

{%- set name     = 'OSX' -%}
{%- set icon     = 'images/download/mac-osx.png' -%}
{%- set filename = 'I2P-%s.dmg' -%}
{%- set filename_arm64 = 'I2P-arm64-%s.dmg' -%}
{%- set hash     = '4bd75d633d497cc25cd256ec7cfcddec2a25d87ad118d0c125c788623d23a98e' -%}
{%- set hash_arm64 = '773bcf127a2e1c0eafee944753a772426c1f7b5c6a8fb3f4d0b7e87bdcfc840b' -%}

<p><b>Important Note:</b>
The 2.1.0 Mac OSX Easy Install Bundle release is delayed.
Please install the 1.9.0 release below.
You will be notified in the router console when the 2.1.0 update is available.
Thank you for your patience.
</p>

{% call package_outer('osx', name, icon) %}
    <div class = "file">
	    <a class = "default" href="{{ url_for('downloads_redirect', version=mver(), net=def_mirror.net, protocol=def_mirror.protocol, domain=def_mirror.domain, file=mver(filename) )}}">
                    <span class = "name">Intel (x86-64)</span><br/>
		    <span class = "name">{{ mver(filename) }}</span><br/>
		    <span class="mirror">{{ _('Mirror:') }} <img src="{{ url_for('static', filename='images/flags/'+def_mirror.country+'.png') }}" /> {{ def_mirror.org }}</span>
	    </a>
	    <a class="mirrors" href="{{ get_url('downloads_select', version=mver(), file=mver(filename)) }}">{{ _('select alternate mirror') }}</a>
    </div>
    <div class="meta">
	    <div class="hash">
		    <code>{{ hash }}</code>
	    </div>
    </div>
{% endcall %}

{% call package_outer('osx', name, icon) %}
    <div class = "file">
	    <a class = "default" href="{{ url_for('downloads_redirect', version=mver(), net=def_mirror.net, protocol=def_mirror.protocol, domain=def_mirror.domain, file=mver(filename_arm64) )}}">
                    <span class = "name">Apple Silicon (arm64)</span><br/>
		    <span class = "name">{{ mver(filename_arm64) }}</span><br/>
		    <span class="mirror">{{ _('Mirror:') }} <img src="{{ url_for('static', filename='images/flags/'+def_mirror.country+'.png') }}" /> {{ def_mirror.org }}</span>
	    </a>
	    <a class="mirrors" href="{{ get_url('downloads_select', version=mver(), file=mver(filename_arm64)) }}">{{ _('select alternate mirror') }}</a>
    </div>
    <div class="meta">
	    <div class="hash">
		    <code>{{ hash_arm64 }}</code>
	    </div>
    </div>
{% endcall %}

<h2>{{ _('Instructions') }}</h2>
<p>{% trans -%}
Download the appropriate file for your Mac hardware and double-click on it.  Accept the License Agreement, then
drag the <code>I2P</code> icon on top of the <code>Applications</code> icon.
Launch I2P from Finder.
{%- endtrans %}</p>

<h3>{{ _('Apple Silicon Notes') }}</h3>
<p>{% trans -%}
If you own an Apple silicon Mac and have previously installed the Intel bundle on it you need to change the update configuration to make sure the next I2P update does not revert your bundle to Intel.
{%- endtrans %}</p>

<p>{% trans -%}
Go to the "Configure Update" page, usually located at:
{%- endtrans %}</p> 
<code>http://127.0.0.1:7657/configupdate</code>
<p>{% trans -%}
Then copy-paste the following in the "News URL" field:
{%- endtrans %}</p> 
<code>http://tc73n4kivdroccekirco7rhgxdg5f3cjvbaapabupeyzrqwv5guq.b32.i2p/mac-arm64/stable/news.su3</code>

<h2>{{ _('Limitations') }}</h2>
<p>{% trans -%}
I2P will not install any launch agents on your Mac.  If you want I2P to start on
system startup, you need to configure a launch agent yourself. You can configure
I2P to launch when your user logs in by right-clicking on the I2P Dock icon.
{%- endtrans %}</p>
<h3>{{ _('Source Code and Issue Tracking') }}</h3>
<div>{% trans -%}
If you would like to examine the source code for individual components, you may
find it on i2pgit.org.  
{%- endtrans %}</div>
<div><a href="https://i2pgit.org/i2p-hackers/i2p-jpackage-mac">{% trans -%}Gitlab Repository{%- endtrans %}</a></div>
<div>{% trans -%}
If you wish to file an issue about the DMG Bundle, please use Gitlab to
contact us. For security-sensitive issues, please remember to check the
"This issue is confidential and should only be visible to team members with at
least Reporter access" option when filing the issue.
{%- endtrans %}</div>
<div><a href="https://i2pgit.org/i2p-hackers/i2p-jpackage-mac/issues">{% trans -%}Gitlab Repository{%- endtrans %}</a></div>

{% endblock %}