| <!DOCTYPE html><html><head><meta charset="utf-8"><title>Apache Pony Mail (Incubating)</title> |
| <link rel="stylesheet" type="text/css" href="/css/default.css"/> |
| <link rel="stylesheet" type="text/css" href="/css/fa/fa.css"/> |
| <link rel="apple-touch-icon" sizes="57x57" href="/icons/apple-icon-57x57.png"> |
| <link rel="apple-touch-icon" sizes="60x60" href="/icons/apple-icon-60x60.png"> |
| <link rel="apple-touch-icon" sizes="72x72" href="/icons/apple-icon-72x72.png"> |
| <link rel="apple-touch-icon" sizes="76x76" href="/icons/apple-icon-76x76.png"> |
| <link rel="apple-touch-icon" sizes="114x114" href="/icons/apple-icon-114x114.png"> |
| <link rel="apple-touch-icon" sizes="120x120" href="/icons/apple-icon-120x120.png"> |
| <link rel="apple-touch-icon" sizes="144x144" href="/icons/apple-icon-144x144.png"> |
| <link rel="apple-touch-icon" sizes="152x152" href="/icons/apple-icon-152x152.png"> |
| <link rel="apple-touch-icon" sizes="180x180" href="/icons/apple-icon-180x180.png"> |
| <link rel="icon" type="image/png" sizes="192x192" href="/android-icon-192x192.png"> |
| <link rel="icon" type="image/png" sizes="32x32" href="/icons/favicon-32x32.png"> |
| <link rel="icon" type="image/png" sizes="96x96" href="/icons/favicon-96x96.png"> |
| <link rel="icon" type="image/png" sizes="16x16" href="/icons/favicon-16x16.png"> |
| <link rel="manifest" href="/icons/manifest.json"> |
| <meta name="msapplication-TileColor" content="#ffffff"> |
| <meta name="msapplication-TileImage" content="/icons/ms-icon-144x144.png"> |
| <meta name="theme-color" content="#ffffff"> |
| </head><body> |
| <div id="titlebar"> |
| <a href="/contribute.html"><img align='left' style="width: 130px; height: 125px; position: relative; left: -6px; top: -6px; border: 0;" src="/images/devme.png" alt="Fork/Hack on Pony Mail"></a> |
| <a href='/'><img src="/images/ponymail.svg" style="width: 110px; margin-left: -10px; margin-right: 20px; height: auto;" align="left"/></a> |
| <h1><a id="title" href="/" style="color: #FFF !important;">Apache Pony Mail™ (Incubating)</a></h1> |
| <div id="menubar"> |
| <ul> |
| <li><a href="/docs.html"><i class="fa fa-book"></i><span>Documentation</span></a></li> |
| <li><a href="/source.html"><i class="fa fa-git-square"></i><span>Source</span></a></li> |
| <li><a href="/downloads.html"><i class="fa fa-cloud-download"></i><span>Download</span></a></li> |
| <li><a href="/support.html"><i class="fa fa-question-circle"></i><span>Get support</span></a></li> |
| <li><a href="/contribute.html"><i class="fa fa-share-alt"></i><span>Contribute</span></a></li> |
| <li><a href="/about.html"><i class="fa fa-users"></i><span>About</span></a></li> |
| </ul> |
| </div> |
| </div> |
| <h1 id='installingponymailonfedora22'>Installing Pony Mail on Fedora 22:<a href='#installingponymailonfedora22' style='color: rgba(0,0,0,0);'>¶</a></h1> |
| <p>Start by installing the following Fedora packages:</p> |
| <ul> |
| <li>httpd</li> |
| <li>git</li> |
| <li>lua</li> |
| <li>lua-sec</li> |
| <li>lua-socket</li> |
| <li>python 3</li> |
| <li>luarocks</li> |
| </ul> |
| <pre> |
| sudo dnf install -y httpd git lua lua-sec lua-socket python3 luarocks |
| </pre> |
| |
| <p>Install the missing cjson package via luarocks:</p> |
| <pre> |
| sudo luarocks-5.3 install lua-cjson |
| </pre> |
| |
| <p>Install the required Python 3 modules: |
| <pre> |
| sudo pip3.4 install elasticsearch formatflowed chardet netaddr |
| </pre></p> |
| <p>Install ElasticSearch:</p> |
| <pre> |
| sudo dnf install -y java-1.8.0-openjdk-headless |
| sudo rpm --import https://packages.elastic.co/GPG-KEY-elasticsearch |
| |
| (The following is taken from the ElasticSearch online guide:) |
| |
| Add the following in your /etc/yum.repos.d/ directory in a file with a .repo suffix, |
| for example elasticsearch.repo: |
| |
| [elasticsearch-1.7] |
| name=Elasticsearch repository for 1.7.x packages |
| baseurl=http://packages.elastic.co/elasticsearch/1.7/centos |
| gpgcheck=1 |
| gpgkey=http://packages.elastic.co/GPG-KEY-elasticsearch |
| enabled=1 |
| |
| |
| sudo dnf install -y elasticsearch |
| </pre> |
| |
| <p>Configure and start up ElasticSearch:</p> |
| <pre> |
| sudo /bin/systemctl daemon-reload |
| sudo /bin/systemctl enable elasticsearch.service |
| sudo /etc/init.d/elasticsearch start |
| </pre> |
| |
| <p>Check out a copy of Pony Mail: |
| <pre> |
| cd /var/www |
| sudo git clone https://github.com/apache/incubator-ponymail-foal.git |
| </pre></p> |
| <p>Set up Pony Mail: |
| <pre> |
| cd /var/www/ponymail/tools |
| sudo python3.4 setup.py |
| [... answer questions asked by the setup script ...] |
| </pre></p> |
| <p>Set up Apache httpd by adding, for example, the following virtual host configuration: |
| This differs from the normal installation (because of CentOS specifics), so beware</p> |
| <pre> |
| <VirtualHost *:80> |
| LuaPackageCPath /usr/lib/lua/5.3/?.so |
| LuaPackagePath /usr/share/lua/5.3/?.lua |
| ServerName mylists.foo.tld |
| DocumentRoot /var/www/ponymail/site |
| AddHandler lua-script .lua |
| LuaScope thread |
| LuaCodeCache stat |
| AcceptPathInfo On |
| </VirtualHost> |
| </pre> |
| |
| <p>(re)start apache:</p> |
| <pre> |
| sudo apachectl restart |
| </pre> |
| |
| <p>IF you have SELinux running, you need to allow httpd (apache) to |
| be able to connect to remotes, otherwise Pony Mail won't work:</p> |
| <pre> |
| sudo setsebool -P httpd_can_network_connect 1 |
| </pre> |
| |
| <p>Once this is done, you should now have a <em>working copy</em> of Pony Mail!</p> |
| <p>You may wish to tweak the settings in <code>site/js/config.js</code> and your |
| elasticsearch settings once Pony mail is up and running.</p> |
| <p>Refer to the <a href="installing.html">General installation documentation</a> for |
| detailed information about archiving messages, OAuth, mail settings and |
| much more.</p> |
| <div style="display: inline-block; background: #BBB; margin: -10px; padding: 10px;"> |
| <h4><a id="disclaimer"></a>Disclaimer</h4> |
| <div style="width: 65%; float: left;"> |
| <p style="line-height: 12pt;"> |
| Apache Pony Mail (Incubating) is an effort undergoing incubation at |
| The Apache Software Foundation (ASF), sponsored by the <a href="https://incubator.apache.org"> |
| Apache Incubator</a>. Incubation is required of all newly accepted projects |
| until a further review indicates that the infrastructure, |
| communications, and decision making process have stabilized in a |
| manner consistent with other successful ASF projects. While |
| incubation status is not necessarily a reflection of the |
| completeness or stability of the code, it does indicate that the |
| project has yet to be fully endorsed by the ASF. |
| </p> |
| </div> |
| <div style="width: 20%; float: left; padding-top: 16px; margin-left: -8px;"> |
| <a href="https://incubator.apache.org"><img src="https://incubator.apache.org/images/incubator_feather_egg_logo_sm.png"/></a> |
| </div> |
| <div style="width: 15%; float: left; line-height: 15px; padding-left: 22px;"> |
| <a class="item" target="_blank" href="https://incubator.apache.org/">Apache Incubator</a><br/> |
| <a class="item" target="_blank" href="https://www.apache.org/">About the ASF<span></span></a><br/> |
| <a class="item" target="_blank" href="https://www.apache.org/foundation/policies/conduct.html">Code of Conduct<span></span></a><br/> |
| <a class="item" target="_blank" href="https://www.apache.org/foundation/thanks.html">Thanks<span></span></a><br/> |
| <a class="item" target="_blank" href="https://www.apache.org/foundation/sponsorship.html">Become a Sponsor<span></span></a><br/> |
| <a class="item" target="_blank" href="https://www.apache.org/security/">Security<span></span></a><br/> |
| <a class="item" target="_blank" href="https://www.apache.org/licenses/LICENSE-2.0">License<span></span></a><br/> |
| </div> |
| </div> |
| </body></html> |
