A installation/0-install.iredadmin.on.debian.md
A installation/0-install.iredadmin.on.freebsd.md A installation/0-install.iredadmin.on.openbsd.md A installation/0-install.iredadmin.on.rhel.md
This commit is contained in:
parent
7e46fe2d98
commit
8efbe81b4f
16
TODO.md
16
TODO.md
|
@ -1,13 +1,5 @@
|
|||
# TODO
|
||||
|
||||
* iRedAdmin-Pro installation guides
|
||||
|
||||
* http://www.iredmail.org/admin_installation_debian.html
|
||||
* http://www.iredmail.org/admin_installation_opensuse.html
|
||||
* http://www.iredmail.org/admin_installation_freebsd.html
|
||||
* http://www.iredmail.org/admin_installation_rhel.html
|
||||
* http://www.iredmail.org/admin_installation_openbsd.html
|
||||
|
||||
* How to enable SSHA512/BCRYPT in Dovecot + Roundcubemail.
|
||||
* How to custom SpamAssassin scores
|
||||
* How to enable DNSBL in Postfix.
|
||||
|
@ -29,6 +21,14 @@
|
|||
|
||||
# installation guides
|
||||
|
||||
* ~~ iRedAdmin-Pro installation guides ~~
|
||||
|
||||
* ~~ http://www.iredmail.org/admin_installation_debian.html ~~
|
||||
* http://www.iredmail.org/admin_installation_opensuse.html
|
||||
* ~~ http://www.iredmail.org/admin_installation_freebsd.html ~~
|
||||
* ~~ http://www.iredmail.org/admin_installation_rhel.html ~~
|
||||
* ~~ http://www.iredmail.org/admin_installation_openbsd.html ~~
|
||||
|
||||
* ~~http://www.iredmail.org/install_iredmail_on_debian.html~~
|
||||
* ~~http://www.iredmail.org/install_iredmail_on_ubuntu.html~~
|
||||
* ~~http://www.iredmail.org/install_iredmail_on_freebsd.html~~
|
||||
|
|
|
@ -0,0 +1,163 @@
|
|||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<title>Install iRedAdmin on Debian, Ubuntu</title>
|
||||
<link href="./css/markdown.css" rel="stylesheet"></head>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="navigation">
|
||||
<a href="http://www.iredmail.org" target="_blank">iRedMail web site</a>
|
||||
|
||||
// <a href="./index.html">Document Index</a>
|
||||
</div><h1 id="install-iredadmin-on-debian-ubuntu">Install iRedAdmin on Debian, Ubuntu</h1>
|
||||
<blockquote>
|
||||
<p>This tutorial is used to install iRedAdmin from scratch, running under Apache
|
||||
web server.</p>
|
||||
<p>If you already have iRedAdmin open source edition or old iRedAdmin-Pro release
|
||||
installed, you can simply migrate it to the latest iRedAdmin by follow our short
|
||||
tutorial: <a href="./migrate.or.upgrade.iredadmin.html">Migrate or upgrade iRedAdmin</a>.</p>
|
||||
</blockquote>
|
||||
<h2 id="requirements">Requirements</h2>
|
||||
<blockquote>
|
||||
<p>iRedMail will install all required packages for you, you don't need to
|
||||
install them manually.</p>
|
||||
</blockquote>
|
||||
<ul>
|
||||
<li>
|
||||
<p><code>Apache</code> 2.2+. Web server.</p>
|
||||
<ul>
|
||||
<li><code>mod_wsgi</code> 2.1+. Apache module used to host Python application which supports the Python WSGI interface.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>
|
||||
<p><code>Python</code> 2.4+, core programming language. Warning: Python 3.x is not supported yet.</p>
|
||||
<ul>
|
||||
<li><code>web.py</code>, 0.32+. A python-powered web framework.</li>
|
||||
<li><code>MySQLdb</code>: A thread-compatible interface to the popular MySQL database server that provides the Python database API. Required if you store mail accounts in OpenLDAP, MySQL or MariaDB.</li>
|
||||
<li><code>Python-LDAP</code> 2.3.7+: An object-oriented API to access LDAP directory servers from Python programs. Required if you store mail accounts in OpenLDAP.</li>
|
||||
<li><code>Python-psycopg2</code>: interface to the PostgreSQL database server from Python programs. Required if you store mail accounts in PostgreSQL.</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<h2 id="download-iredadmin-and-configure-apache-web-server">Download iRedAdmin and configure Apache web server</h2>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Download iRedAdmin open source edition <a href="http://www.iredmail.org/yum/misc/">here</a>.
|
||||
If you're trying to install iRedAdmin-Pro, please <a href="../contact.html">contact us</a>
|
||||
to get download link of iRedAdmin-Pro.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Copy iRedAdmin to <code>/usr/share/apache2/</code>, set correct file permissions, and create symbol link.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code># tar xjf iRedAdmin-x.y.z.tar.bz2 -C /usr/share/apache2/
|
||||
# cd /usr/share/apache2/
|
||||
# chown -R iredadmin:iredadmin iRedAdmin-x.y.z
|
||||
# chmod -R 0555 iRedAdmin-x.y.z
|
||||
# ln -s iRedAdmin-x.y.z iredadmin
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>
|
||||
<p>Add apache configure file: <code>/etc/apache2/conf.d/iredadmin.conf</code>.</p>
|
||||
<p>Note: If you're running Ubuntu 14.04 or later releases, it's
|
||||
<code>/etc/apache2/conf-available/iredadmin.conf</code>. After you added this file,
|
||||
enable it with command <code>a2enconf iredadmin</code>.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code>WSGISocketPrefix /var/run/wsgi
|
||||
WSGIDaemonProcess iredadmin user=iredadmin threads=15
|
||||
WSGIProcessGroup iredadmin
|
||||
|
||||
AddType text/html .py
|
||||
|
||||
<Directory /usr/share/apache2/iredadmin/>
|
||||
Order deny,allow
|
||||
Allow from all
|
||||
</Directory>
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Edit <code>/etc/apache2/sites-enabled/default-ssl</code>, make iredadmin accessible via HTTPS.
|
||||
Add below lines before <code></VirtualHost></code>:</li>
|
||||
</ul>
|
||||
<pre><code>WSGIScriptAlias /iredadmin /usr/share/apache2/iredadmin/iredadmin.py/
|
||||
Alias /iredadmin/static /usr/share/apache2/iredadmin/static/
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Restart apache to enable mod_wsgi:</li>
|
||||
</ul>
|
||||
<pre><code># a2enmod wsgi
|
||||
# /etc/init.d/apache2 restart
|
||||
</code></pre>
|
||||
|
||||
<h2 id="create-required-mysql-database-and-grant-privileges">Create required MySQL database and grant privileges</h2>
|
||||
<ul>
|
||||
<li>Create MySQL database: <code>iredadmin</code>.</li>
|
||||
</ul>
|
||||
<pre><code># mysql -uroot -p
|
||||
mysql> CREATE DATABASE iredadmin DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
|
||||
mysql> USE iredadmin;
|
||||
mysql> SOURCE /usr/share/apache2/iredadmin/docs/samples/iredadmin.sql;
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Grant privileges to iredadmin user and set password for it. WARNING: Here we
|
||||
use 'secret_passwd' as password of iredadmin user, please replace it with
|
||||
your own password.</li>
|
||||
</ul>
|
||||
<pre><code># mysql -uroot -p
|
||||
mysql> GRANT SELECT,INSERT,UPDATE,DELETE ON iredadmin.* TO iredadmin@localhost IDENTIFIED BY 'secret_passwd';
|
||||
mysql> FLUSH PRIVILEGES;
|
||||
</code></pre>
|
||||
|
||||
<h2 id="configure-iredadmin">Configure iRedAdmin</h2>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Copy sample config file, and make it not world-writeable.</p>
|
||||
<ul>
|
||||
<li>settings.py.ldap.sample: sample config file for OpenLDAP backend</li>
|
||||
<li>settings.py.mysql.sample: sample config file for MySQL/MariaDB backend</li>
|
||||
<li>settings.py.pgsql.sample: sample config file for PostgreSQL backend</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code># cd /usr/share/apache2/iredadmin/
|
||||
# cp settings.py.[backend].sample settings.py
|
||||
# chown iredadmin:iredadmin settings.py
|
||||
# chmod 0400 settings.py
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>
|
||||
<p>Update settings.py with correct values. Please read <code>settings.py</code> for more
|
||||
information, it's self-documented.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Restart apache web server.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code># /etc/init.d/apache2 restart
|
||||
</code></pre>
|
||||
|
||||
<h2 id="access-iredadmin">Access iRedAdmin</h2>
|
||||
<p>Open your web browser to access iRedAdmin: <code>httpS://your_server_ip_address/iredadmin/</code></p>
|
||||
<p>Make sure you use <code>HTTPS://</code> instead of <code>HTTP://</code>.</p>
|
||||
<h2 id="troubleshooting-debug">Troubleshooting & Debug</h2>
|
||||
<p>If iRedAdmin doesn't work as expected, you can simplily set <code>DEBUG = True</code> in
|
||||
<code>settings.py</code>, restart apache web server, use your favourite web browser to
|
||||
access it again, create a new <a href="http://www.iredmail.org/forum/">forum</a> topic and
|
||||
paste error message in your forum topic.</p><p style="text-align: center; color: grey;">Document published under a <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">CC BY-ND 3.0</a> license. If you found something wrong, please do <a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.<!-- Google Analytics -->
|
||||
<script type="text/javascript">
|
||||
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
|
||||
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
|
||||
</script>
|
||||
<script type="text/javascript">
|
||||
try {
|
||||
var pageTracker = _gat._getTracker("UA-3293801-14");
|
||||
pageTracker._trackPageview();
|
||||
} catch(err) {}
|
||||
</script>
|
||||
</body></html>
|
|
@ -0,0 +1,157 @@
|
|||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<title>Install iRedAdmin on FreeBSD</title>
|
||||
<link href="./css/markdown.css" rel="stylesheet"></head>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="navigation">
|
||||
<a href="http://www.iredmail.org" target="_blank">iRedMail web site</a>
|
||||
|
||||
// <a href="./index.html">Document Index</a>
|
||||
</div><h1 id="install-iredadmin-on-freebsd">Install iRedAdmin on FreeBSD</h1>
|
||||
<blockquote>
|
||||
<p>This tutorial is used to install iRedAdmin from scratch, running under Apache
|
||||
web server.</p>
|
||||
<p>If you already have iRedAdmin open source edition or old iRedAdmin-Pro release
|
||||
installed, you can simply migrate it to the latest iRedAdmin by follow our short
|
||||
tutorial: <a href="./migrate.or.upgrade.iredadmin.html">Migrate or upgrade iRedAdmin</a>.</p>
|
||||
</blockquote>
|
||||
<h2 id="requirements">Requirements</h2>
|
||||
<blockquote>
|
||||
<p>iRedMail will install all required packages for you, you don't need to
|
||||
install them manually.</p>
|
||||
</blockquote>
|
||||
<ul>
|
||||
<li>
|
||||
<p><code>Apache</code> 2.2+. Web server.</p>
|
||||
<ul>
|
||||
<li><code>mod_wsgi</code> 2.1+. Apache module used to host Python application which supports the Python WSGI interface.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>
|
||||
<p><code>Python</code> 2.4+, core programming language. Warning: Python 3.x is not supported yet.</p>
|
||||
<ul>
|
||||
<li><code>web.py</code>, 0.32+. A python-powered web framework.</li>
|
||||
<li><code>MySQLdb</code>: A thread-compatible interface to the popular MySQL database server that provides the Python database API. Required if you store mail accounts in OpenLDAP, MySQL or MariaDB.</li>
|
||||
<li><code>Python-LDAP</code> 2.3.7+: An object-oriented API to access LDAP directory servers from Python programs. Required if you store mail accounts in OpenLDAP.</li>
|
||||
<li><code>Python-psycopg2</code>: interface to the PostgreSQL database server from Python programs. Required if you store mail accounts in PostgreSQL.</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<h2 id="download-iredadmin-and-configure-apache-web-server">Download iRedAdmin and configure Apache web server</h2>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Download iRedAdmin open source edition <a href="http://www.iredmail.org/yum/misc/">here</a>.
|
||||
If you're trying to install iRedAdmin-Pro, please <a href="../contact.html">contact us</a>
|
||||
to get download link of iRedAdmin-Pro.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Copy iRedAdmin to <code>/usr/local/www/</code>, set correct file permissions, and create symbol link.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code># tar xjf iRedAdmin-x.y.z.tar.bz2 -C /usr/local/www/
|
||||
# cd /usr/local/www/
|
||||
# chown -R iredadmin:iredadmin iRedAdmin-x.y.z
|
||||
# chmod -R 0555 iRedAdmin-x.y.z
|
||||
# ln -s iRedAdmin-x.y.z iredadmin
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Add apache configure file: <code>/usr/local/etc/apache22/Includes/iredadmin.conf</code>:</li>
|
||||
</ul>
|
||||
<pre><code>WSGISocketPrefix /var/run/wsgi
|
||||
WSGIDaemonProcess iredadmin user=iredadmin threads=15
|
||||
WSGIProcessGroup iredadmin
|
||||
|
||||
AddType text/html .py
|
||||
|
||||
<Directory /usr/local/www/iredadmin/>
|
||||
Order deny,allow
|
||||
Allow from all
|
||||
</Directory>
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Edit <code>/usr/local/etc/apache22/extra/httpd-ssl.conf</code>, make iredadmin accessible via HTTPS.
|
||||
Add below lines before <code></VirtualHost></code>:</li>
|
||||
</ul>
|
||||
<pre><code>WSGIScriptAlias /iredadmin /usr/local/www/iredadmin/iredadmin.py/
|
||||
Alias /iredadmin/static /usr/local/www/iredadmin/static/
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Restart apache to enable mod_wsgi:</li>
|
||||
</ul>
|
||||
<pre><code># /usr/local/etc/rc.d/apache22 restart
|
||||
</code></pre>
|
||||
|
||||
<h2 id="create-required-mysql-database-and-grant-privileges">Create required MySQL database and grant privileges</h2>
|
||||
<ul>
|
||||
<li>Create MySQL database: <code>iredadmin</code>.</li>
|
||||
</ul>
|
||||
<pre><code># mysql -uroot -p
|
||||
mysql> CREATE DATABASE iredadmin DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
|
||||
mysql> USE iredadmin;
|
||||
mysql> SOURCE /usr/local/www/iredadmin/docs/samples/iredadmin.sql;
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Grant privileges to iredadmin user and set password for it. WARNING: Here we
|
||||
use 'secret_passwd' as password of iredadmin user, please replace it with
|
||||
your own password.</li>
|
||||
</ul>
|
||||
<pre><code># mysql -uroot -p
|
||||
mysql> GRANT SELECT,INSERT,UPDATE,DELETE ON iredadmin.* TO iredadmin@localhost IDENTIFIED BY 'secret_passwd';
|
||||
mysql> FLUSH PRIVILEGES;
|
||||
</code></pre>
|
||||
|
||||
<h2 id="configure-iredadmin">Configure iRedAdmin</h2>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Copy sample config file, and make it not world-writeable.</p>
|
||||
<ul>
|
||||
<li>settings.py.ldap.sample: sample config file for OpenLDAP backend</li>
|
||||
<li>settings.py.mysql.sample: sample config file for MySQL/MariaDB backend</li>
|
||||
<li>settings.py.pgsql.sample: sample config file for PostgreSQL backend</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code># cd /usr/local/www/iredadmin/
|
||||
# cp settings.py.[backend].sample settings.py
|
||||
# chown iredadmin:iredadmin settings.py
|
||||
# chmod 0400 settings.py
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>
|
||||
<p>Update settings.py with correct values. Please read <code>settings.py</code> for more
|
||||
information, it's self-documented.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Restart apache web server.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code># /usr/local/etc/rc.d/apache22 restart
|
||||
</code></pre>
|
||||
|
||||
<h2 id="access-iredadmin">Access iRedAdmin</h2>
|
||||
<p>Open your web browser to access iRedAdmin: <code>httpS://your_server_ip_address/iredadmin/</code></p>
|
||||
<p>Make sure you use <code>HTTPS://</code> instead of <code>HTTP://</code>.</p>
|
||||
<h2 id="troubleshooting-debug">Troubleshooting & Debug</h2>
|
||||
<p>If iRedAdmin doesn't work as expected, you can simplily set <code>DEBUG = True</code> in
|
||||
<code>settings.py</code>, restart apache web server, use your favourite web browser to
|
||||
access it again, create a new <a href="http://www.iredmail.org/forum/">forum</a> topic and
|
||||
paste error message in your forum topic.</p><p style="text-align: center; color: grey;">Document published under a <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">CC BY-ND 3.0</a> license. If you found something wrong, please do <a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.<!-- Google Analytics -->
|
||||
<script type="text/javascript">
|
||||
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
|
||||
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
|
||||
</script>
|
||||
<script type="text/javascript">
|
||||
try {
|
||||
var pageTracker = _gat._getTracker("UA-3293801-14");
|
||||
pageTracker._trackPageview();
|
||||
} catch(err) {}
|
||||
</script>
|
||||
</body></html>
|
|
@ -0,0 +1,153 @@
|
|||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<title>Install iRedAdmin on OpenBSD</title>
|
||||
<link href="./css/markdown.css" rel="stylesheet"></head>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="navigation">
|
||||
<a href="http://www.iredmail.org" target="_blank">iRedMail web site</a>
|
||||
|
||||
// <a href="./index.html">Document Index</a>
|
||||
</div><h1 id="install-iredadmin-on-openbsd">Install iRedAdmin on OpenBSD</h1>
|
||||
<blockquote>
|
||||
<p>This tutorial is used to install iRedAdmin from scratch, running under Apache
|
||||
web server.</p>
|
||||
<p>If you already have iRedAdmin open source edition or old iRedAdmin-Pro release
|
||||
installed, you can simply migrate it to the latest iRedAdmin by follow our short
|
||||
tutorial: <a href="./migrate.or.upgrade.iredadmin.html">Migrate or upgrade iRedAdmin</a>.</p>
|
||||
</blockquote>
|
||||
<p>NOTE: This tutorial must be rewritten to use Nginx as web server since OpenBSD
|
||||
5.6 removes Apache-1.3 in base system, and Nginx will be removed since OpenBSD
|
||||
5.7.</p>
|
||||
<h2 id="requirements">Requirements</h2>
|
||||
<blockquote>
|
||||
<p>iRedMail will install all required packages for you, you don't need to
|
||||
install them manually.</p>
|
||||
</blockquote>
|
||||
<ul>
|
||||
<li><code>Apache</code> 1.3+, the built-in Apache web server in base system.</li>
|
||||
<li>
|
||||
<p><code>Python</code> 2.4+, core programming language. Warning: Python 3.x is not supported yet.</p>
|
||||
<ul>
|
||||
<li><code>web.py</code>, 0.32+. A python-powered web framework.</li>
|
||||
<li><code>MySQLdb</code>: A thread-compatible interface to the popular MySQL database server that provides the Python database API. Required if you store mail accounts in OpenLDAP, MySQL or MariaDB.</li>
|
||||
<li><code>Python-LDAP</code> 2.3.7+: An object-oriented API to access LDAP directory servers from Python programs. Required if you store mail accounts in OpenLDAP.</li>
|
||||
<li><code>Python-psycopg2</code>: interface to the PostgreSQL database server from Python programs. Required if you store mail accounts in PostgreSQL.</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<h2 id="download-iredadmin-and-configure-apache-web-server">Download iRedAdmin and configure Apache web server</h2>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Download iRedAdmin open source edition <a href="http://www.iredmail.org/yum/misc/">here</a>.
|
||||
If you're trying to install iRedAdmin-Pro, please <a href="../contact.html">contact us</a>
|
||||
to get download link of iRedAdmin-Pro.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Copy iRedAdmin to <code>/var/www/</code>, set correct file permissions, and create symbol link.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code># tar xjf iRedAdmin-x.y.z.tar.bz2 -C /var/www/
|
||||
# cd /var/www/
|
||||
# chown -R iredadmin:iredadmin iRedAdmin-x.y.z
|
||||
# chmod -R 0555 iRedAdmin-x.y.z
|
||||
# ln -s iRedAdmin-x.y.z iredadmin
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Add apache configure file: <code>/var/www/conf/modules/iredadmin.conf</code>.</li>
|
||||
</ul>
|
||||
<pre><code>AddType text/html .py
|
||||
AddHandler cgi-script .py
|
||||
|
||||
<Directory /var/www/iredadmin/>
|
||||
Options +ExecCGI
|
||||
Order deny,allow
|
||||
Allow from all
|
||||
</Directory>
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Edit <code>/var/www/conf/httpd.conf</code>, make iredadmin accessible via HTTPS.
|
||||
Add below lines before <code></VirtualHost></code>:</li>
|
||||
</ul>
|
||||
<pre><code>Alias /iredadmin/static /var/www/iredadmin/static
|
||||
ScriptAlias /iredadmin /var/www/iredadmin/iredadmin.py
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Restart apache to enable mod_wsgi:</li>
|
||||
</ul>
|
||||
<pre><code># /etc/rc.d/httpd restart
|
||||
</code></pre>
|
||||
|
||||
<h2 id="create-required-mysql-database-and-grant-privileges">Create required MySQL database and grant privileges</h2>
|
||||
<ul>
|
||||
<li>Create MySQL database: <code>iredadmin</code>.</li>
|
||||
</ul>
|
||||
<pre><code># mysql -uroot -p
|
||||
mysql> CREATE DATABASE iredadmin DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
|
||||
mysql> USE iredadmin;
|
||||
mysql> SOURCE /var/www/iredadmin/docs/samples/iredadmin.sql;
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Grant privileges to iredadmin user and set password for it. WARNING: Here we
|
||||
use 'secret_passwd' as password of iredadmin user, please replace it with
|
||||
your own password.</li>
|
||||
</ul>
|
||||
<pre><code># mysql -uroot -p
|
||||
mysql> GRANT SELECT,INSERT,UPDATE,DELETE ON iredadmin.* TO iredadmin@localhost IDENTIFIED BY 'secret_passwd';
|
||||
mysql> FLUSH PRIVILEGES;
|
||||
</code></pre>
|
||||
|
||||
<h2 id="configure-iredadmin">Configure iRedAdmin</h2>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Copy sample config file, and make it not world-writeable.</p>
|
||||
<ul>
|
||||
<li>settings.py.ldap.sample: sample config file for OpenLDAP backend</li>
|
||||
<li>settings.py.mysql.sample: sample config file for MySQL/MariaDB backend</li>
|
||||
<li>settings.py.pgsql.sample: sample config file for PostgreSQL backend</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code># cd /var/www/iredadmin/
|
||||
# cp settings.py.[backend].sample settings.py
|
||||
# chown iredadmin:iredadmin settings.py
|
||||
# chmod 0400 settings.py
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>
|
||||
<p>Update settings.py with correct values. Please read <code>settings.py</code> for more
|
||||
information, it's self-documented.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Restart apache web server.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code># /etc/rc.d/httpd restart
|
||||
</code></pre>
|
||||
|
||||
<h2 id="access-iredadmin">Access iRedAdmin</h2>
|
||||
<p>Open your web browser to access iRedAdmin: <code>httpS://your_server_ip_address/iredadmin/</code></p>
|
||||
<p>Make sure you use <code>HTTPS://</code> instead of <code>HTTP://</code>.</p>
|
||||
<h2 id="troubleshooting-debug">Troubleshooting & Debug</h2>
|
||||
<p>If iRedAdmin doesn't work as expected, you can simplily set <code>DEBUG = True</code> in
|
||||
<code>settings.py</code>, restart apache web server, use your favourite web browser to
|
||||
access it again, create a new <a href="http://www.iredmail.org/forum/">forum</a> topic and
|
||||
paste error message in your forum topic.</p><p style="text-align: center; color: grey;">Document published under a <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">CC BY-ND 3.0</a> license. If you found something wrong, please do <a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.<!-- Google Analytics -->
|
||||
<script type="text/javascript">
|
||||
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
|
||||
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
|
||||
</script>
|
||||
<script type="text/javascript">
|
||||
try {
|
||||
var pageTracker = _gat._getTracker("UA-3293801-14");
|
||||
pageTracker._trackPageview();
|
||||
} catch(err) {}
|
||||
</script>
|
||||
</body></html>
|
|
@ -0,0 +1,157 @@
|
|||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<title>Install iRedAdmin on Red Hat Enterprise Linux, CentOS, Scientific Linux</title>
|
||||
<link href="./css/markdown.css" rel="stylesheet"></head>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="navigation">
|
||||
<a href="http://www.iredmail.org" target="_blank">iRedMail web site</a>
|
||||
|
||||
// <a href="./index.html">Document Index</a>
|
||||
</div><h1 id="install-iredadmin-on-red-hat-enterprise-linux-centos-scientific-linux">Install iRedAdmin on Red Hat Enterprise Linux, CentOS, Scientific Linux</h1>
|
||||
<blockquote>
|
||||
<p>This tutorial is used to install iRedAdmin from scratch, running under Apache
|
||||
web server.</p>
|
||||
<p>If you already have iRedAdmin open source edition or old iRedAdmin-Pro release
|
||||
installed, you can simply migrate it to the latest iRedAdmin by follow our short
|
||||
tutorial: <a href="./migrate.or.upgrade.iredadmin.html">Migrate or upgrade iRedAdmin</a>.</p>
|
||||
</blockquote>
|
||||
<h2 id="requirements">Requirements</h2>
|
||||
<blockquote>
|
||||
<p>iRedMail will install all required packages for you, you don't need to
|
||||
install them manually.</p>
|
||||
</blockquote>
|
||||
<ul>
|
||||
<li>
|
||||
<p><code>Apache</code> 2.2+. Web server.</p>
|
||||
<ul>
|
||||
<li><code>mod_wsgi</code> 2.1+. Apache module used to host Python application which supports the Python WSGI interface.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>
|
||||
<p><code>Python</code> 2.4+, core programming language. Warning: Python 3.x is not supported yet.</p>
|
||||
<ul>
|
||||
<li><code>web.py</code>, 0.32+. A python-powered web framework.</li>
|
||||
<li><code>MySQLdb</code>: A thread-compatible interface to the popular MySQL database server that provides the Python database API. Required if you store mail accounts in OpenLDAP, MySQL or MariaDB.</li>
|
||||
<li><code>Python-LDAP</code> 2.3.7+: An object-oriented API to access LDAP directory servers from Python programs. Required if you store mail accounts in OpenLDAP.</li>
|
||||
<li><code>Python-psycopg2</code>: interface to the PostgreSQL database server from Python programs. Required if you store mail accounts in PostgreSQL.</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<h2 id="download-iredadmin-and-configure-apache-web-server">Download iRedAdmin and configure Apache web server</h2>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Download iRedAdmin open source edition <a href="http://www.iredmail.org/yum/misc/">here</a>.
|
||||
If you're trying to install iRedAdmin-Pro, please <a href="../contact.html">contact us</a>
|
||||
to get download link of iRedAdmin-Pro.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Copy iRedAdmin to <code>/var/www/</code>, set correct file permissions, and create symbol link.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code># tar xjf iRedAdmin-x.y.z.tar.bz2 -C /var/www/
|
||||
# cd /var/www/
|
||||
# chown -R iredadmin:iredadmin iRedAdmin-x.y.z
|
||||
# chmod -R 0555 iRedAdmin-x.y.z
|
||||
# ln -s iRedAdmin-x.y.z iredadmin
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Add apache configure file: <code>/etc/httpd/conf.d/iredadmin.conf</code>:</li>
|
||||
</ul>
|
||||
<pre><code>WSGISocketPrefix /var/run/wsgi
|
||||
WSGIDaemonProcess iredadmin user=iredadmin threads=15
|
||||
WSGIProcessGroup iredadmin
|
||||
|
||||
AddType text/html .py
|
||||
|
||||
<Directory /var/www/iredadmin/>
|
||||
Order deny,allow
|
||||
Allow from all
|
||||
</Directory>
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Edit <code>/etc/httpd/conf.d/ssl.conf</code>, make iredadmin accessible via HTTPS.
|
||||
Add below lines before <code></VirtualHost></code>:</li>
|
||||
</ul>
|
||||
<pre><code>WSGIScriptAlias /iredadmin /var/www/iredadmin/iredadmin.py/
|
||||
Alias /iredadmin/static /var/www/iredadmin/static/
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Restart apache to enable mod_wsgi:</li>
|
||||
</ul>
|
||||
<pre><code># /etc/init.d/httpd restart
|
||||
</code></pre>
|
||||
|
||||
<h2 id="create-required-mysql-database-and-grant-privileges">Create required MySQL database and grant privileges</h2>
|
||||
<ul>
|
||||
<li>Create MySQL database: <code>iredadmin</code>.</li>
|
||||
</ul>
|
||||
<pre><code># mysql -uroot -p
|
||||
mysql> CREATE DATABASE iredadmin DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
|
||||
mysql> USE iredadmin;
|
||||
mysql> SOURCE /var/www/iredadmin/docs/samples/iredadmin.sql;
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>Grant privileges to iredadmin user and set password for it. WARNING: Here we
|
||||
use 'secret_passwd' as password of iredadmin user, please replace it with
|
||||
your own password.</li>
|
||||
</ul>
|
||||
<pre><code># mysql -uroot -p
|
||||
mysql> GRANT SELECT,INSERT,UPDATE,DELETE ON iredadmin.* TO iredadmin@localhost IDENTIFIED BY 'secret_passwd';
|
||||
mysql> FLUSH PRIVILEGES;
|
||||
</code></pre>
|
||||
|
||||
<h2 id="configure-iredadmin">Configure iRedAdmin</h2>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Copy sample config file, and make it not world-writeable.</p>
|
||||
<ul>
|
||||
<li>settings.py.ldap.sample: sample config file for OpenLDAP backend</li>
|
||||
<li>settings.py.mysql.sample: sample config file for MySQL/MariaDB backend</li>
|
||||
<li>settings.py.pgsql.sample: sample config file for PostgreSQL backend</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code># cd /var/www/iredadmin/
|
||||
# cp settings.py.[backend].sample settings.py
|
||||
# chown iredadmin:iredadmin settings.py
|
||||
# chmod 0400 settings.py
|
||||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>
|
||||
<p>Update settings.py with correct values. Please read <code>settings.py</code> for more
|
||||
information, it's self-documented.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Restart apache web server.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code># /etc/init.d/httpd restart
|
||||
</code></pre>
|
||||
|
||||
<h2 id="access-iredadmin">Access iRedAdmin</h2>
|
||||
<p>Open your web browser to access iRedAdmin: <code>httpS://your_server_ip_address/iredadmin/</code></p>
|
||||
<p>Make sure you use <code>HTTPS://</code> instead of <code>HTTP://</code>.</p>
|
||||
<h2 id="troubleshooting-debug">Troubleshooting & Debug</h2>
|
||||
<p>If iRedAdmin doesn't work as expected, you can simplily set <code>DEBUG = True</code> in
|
||||
<code>settings.py</code>, restart apache web server, use your favourite web browser to
|
||||
access it again, create a new <a href="http://www.iredmail.org/forum/">forum</a> topic and
|
||||
paste error message in your forum topic.</p><p style="text-align: center; color: grey;">Document published under a <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">CC BY-ND 3.0</a> license. If you found something wrong, please do <a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.<!-- Google Analytics -->
|
||||
<script type="text/javascript">
|
||||
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
|
||||
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
|
||||
</script>
|
||||
<script type="text/javascript">
|
||||
try {
|
||||
var pageTracker = _gat._getTracker("UA-3293801-14");
|
||||
pageTracker._trackPageview();
|
||||
} catch(err) {}
|
||||
</script>
|
||||
</body></html>
|
|
@ -14,7 +14,8 @@
|
|||
<div class="toc">
|
||||
<ul>
|
||||
<li><a href="#iredadmin-pro-release-notes-and-upgrade-tutorial">iRedAdmin-Pro release notes and upgrade tutorial</a><ul>
|
||||
<li><a href="#upgrade-iredadmin-pro">Upgrade iRedAdmin-Pro</a></li>
|
||||
<li><a href="#upgrade-iredadmin">Upgrade iRedAdmin</a></li>
|
||||
<li><a href="#install-iredadmin">Install iRedAdmin</a></li>
|
||||
<li><a href="#release-notes">Release Notes</a><ul>
|
||||
<li><a href="#iredadmin-pro-ldap-for-openldap-backend">iRedAdmin-Pro-LDAP (for OpenLDAP backend)</a></li>
|
||||
<li><a href="#iredadmin-pro-mysql-for-mysqlmariadb-backend">iRedAdmin-Pro-MySQL (for MySQL/MariaDB backend)</a></li>
|
||||
|
@ -25,10 +26,17 @@
|
|||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<h2 id="upgrade-iredadmin-pro">Upgrade iRedAdmin-Pro</h2>
|
||||
<p>With the latest iRedAdmin-Pro, you can simply upgrade old releases by following
|
||||
<h2 id="upgrade-iredadmin">Upgrade iRedAdmin</h2>
|
||||
<p>With the latest iRedAdmin, you can simply upgrade old releases by following
|
||||
this tutorial with just one shell command:
|
||||
<a href="./migrate.or.upgrade.iredadmin.html">Migrate or upgrade iRedAdmin</a></p>
|
||||
<h2 id="install-iredadmin">Install iRedAdmin</h2>
|
||||
<ul>
|
||||
<li><a href="./install.iredadmin.on.rhel.html">Install iRedAdmin on Red Hat Enterprise Linux, CentOS, Scientific Linux</a></li>
|
||||
<li><a href="./install.iredadmin.on.debian.html">Install iRedAdmin on Debian, Ubuntu</a></li>
|
||||
<li><a href="./install.iredadmin.on.freebsd.html">Install iRedAdmin on FreeBSD</a></li>
|
||||
<li><a href="./install.iredadmin.on.openbsd.html">Install iRedAdmin on OpenBSD</a></li>
|
||||
</ul>
|
||||
<h2 id="release-notes">Release Notes</h2>
|
||||
<h3 id="iredadmin-pro-ldap-for-openldap-backend">iRedAdmin-Pro-LDAP (for OpenLDAP backend)</h3>
|
||||
<ul>
|
||||
|
|
|
@ -0,0 +1,132 @@
|
|||
# Install iRedAdmin on Debian, Ubuntu
|
||||
|
||||
> This tutorial is used to install iRedAdmin from scratch, running under Apache
|
||||
> web server.
|
||||
>
|
||||
> If you already have iRedAdmin open source edition or old iRedAdmin-Pro release
|
||||
> installed, you can simply migrate it to the latest iRedAdmin by follow our short
|
||||
> tutorial: [Migrate or upgrade iRedAdmin](./migrate.or.upgrade.iredadmin.html).
|
||||
|
||||
## Requirements
|
||||
|
||||
> iRedMail will install all required packages for you, you don't need to
|
||||
> install them manually.
|
||||
|
||||
* `Apache` 2.2+. Web server.
|
||||
|
||||
* `mod_wsgi` 2.1+. Apache module used to host Python application which supports the Python WSGI interface.
|
||||
|
||||
* `Python` 2.4+, core programming language. Warning: Python 3.x is not supported yet.
|
||||
|
||||
* `web.py`, 0.32+. A python-powered web framework.
|
||||
* `MySQLdb`: A thread-compatible interface to the popular MySQL database server that provides the Python database API. Required if you store mail accounts in OpenLDAP, MySQL or MariaDB.
|
||||
* `Python-LDAP` 2.3.7+: An object-oriented API to access LDAP directory servers from Python programs. Required if you store mail accounts in OpenLDAP.
|
||||
* `Python-psycopg2`: interface to the PostgreSQL database server from Python programs. Required if you store mail accounts in PostgreSQL.
|
||||
|
||||
## Download iRedAdmin and configure Apache web server
|
||||
|
||||
* Download iRedAdmin open source edition [here](http://www.iredmail.org/yum/misc/).
|
||||
If you're trying to install iRedAdmin-Pro, please [contact us](../contact.html)
|
||||
to get download link of iRedAdmin-Pro.
|
||||
|
||||
* Copy iRedAdmin to `/usr/share/apache2/`, set correct file permissions, and create symbol link.
|
||||
|
||||
```
|
||||
# tar xjf iRedAdmin-x.y.z.tar.bz2 -C /usr/share/apache2/
|
||||
# cd /usr/share/apache2/
|
||||
# chown -R iredadmin:iredadmin iRedAdmin-x.y.z
|
||||
# chmod -R 0555 iRedAdmin-x.y.z
|
||||
# ln -s iRedAdmin-x.y.z iredadmin
|
||||
```
|
||||
|
||||
* Add apache configure file: `/etc/apache2/conf.d/iredadmin.conf`.
|
||||
|
||||
Note: If you're running Ubuntu 14.04 or later releases, it's
|
||||
`/etc/apache2/conf-available/iredadmin.conf`. After you added this file,
|
||||
enable it with command `a2enconf iredadmin`.
|
||||
|
||||
```
|
||||
WSGISocketPrefix /var/run/wsgi
|
||||
WSGIDaemonProcess iredadmin user=iredadmin threads=15
|
||||
WSGIProcessGroup iredadmin
|
||||
|
||||
AddType text/html .py
|
||||
|
||||
<Directory /usr/share/apache2/iredadmin/>
|
||||
Order deny,allow
|
||||
Allow from all
|
||||
</Directory>
|
||||
```
|
||||
|
||||
* Edit `/etc/apache2/sites-enabled/default-ssl`, make iredadmin accessible via HTTPS.
|
||||
Add below lines before `</VirtualHost>`:
|
||||
|
||||
```
|
||||
WSGIScriptAlias /iredadmin /usr/share/apache2/iredadmin/iredadmin.py/
|
||||
Alias /iredadmin/static /usr/share/apache2/iredadmin/static/
|
||||
```
|
||||
|
||||
* Restart apache to enable mod_wsgi:
|
||||
|
||||
```
|
||||
# a2enmod wsgi
|
||||
# /etc/init.d/apache2 restart
|
||||
```
|
||||
|
||||
## Create required MySQL database and grant privileges
|
||||
|
||||
* Create MySQL database: `iredadmin`.
|
||||
|
||||
```
|
||||
# mysql -uroot -p
|
||||
mysql> CREATE DATABASE iredadmin DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
|
||||
mysql> USE iredadmin;
|
||||
mysql> SOURCE /usr/share/apache2/iredadmin/docs/samples/iredadmin.sql;
|
||||
```
|
||||
|
||||
* Grant privileges to iredadmin user and set password for it. WARNING: Here we
|
||||
use 'secret_passwd' as password of iredadmin user, please replace it with
|
||||
your own password.
|
||||
|
||||
```
|
||||
# mysql -uroot -p
|
||||
mysql> GRANT SELECT,INSERT,UPDATE,DELETE ON iredadmin.* TO iredadmin@localhost IDENTIFIED BY 'secret_passwd';
|
||||
mysql> FLUSH PRIVILEGES;
|
||||
```
|
||||
|
||||
## Configure iRedAdmin
|
||||
|
||||
* Copy sample config file, and make it not world-writeable.
|
||||
|
||||
* settings.py.ldap.sample: sample config file for OpenLDAP backend
|
||||
* settings.py.mysql.sample: sample config file for MySQL/MariaDB backend
|
||||
* settings.py.pgsql.sample: sample config file for PostgreSQL backend
|
||||
|
||||
```
|
||||
# cd /usr/share/apache2/iredadmin/
|
||||
# cp settings.py.[backend].sample settings.py
|
||||
# chown iredadmin:iredadmin settings.py
|
||||
# chmod 0400 settings.py
|
||||
```
|
||||
|
||||
* Update settings.py with correct values. Please read `settings.py` for more
|
||||
information, it's self-documented.
|
||||
|
||||
* Restart apache web server.
|
||||
|
||||
```
|
||||
# /etc/init.d/apache2 restart
|
||||
```
|
||||
|
||||
## Access iRedAdmin
|
||||
|
||||
Open your web browser to access iRedAdmin: `httpS://your_server_ip_address/iredadmin/`
|
||||
|
||||
Make sure you use `HTTPS://` instead of `HTTP://`.
|
||||
|
||||
## Troubleshooting & Debug
|
||||
|
||||
If iRedAdmin doesn't work as expected, you can simplily set `DEBUG = True` in
|
||||
`settings.py`, restart apache web server, use your favourite web browser to
|
||||
access it again, create a new [forum](http://www.iredmail.org/forum/) topic and
|
||||
paste error message in your forum topic.
|
|
@ -0,0 +1,128 @@
|
|||
# Install iRedAdmin on FreeBSD
|
||||
|
||||
> This tutorial is used to install iRedAdmin from scratch, running under Apache
|
||||
> web server.
|
||||
>
|
||||
> If you already have iRedAdmin open source edition or old iRedAdmin-Pro release
|
||||
> installed, you can simply migrate it to the latest iRedAdmin by follow our short
|
||||
> tutorial: [Migrate or upgrade iRedAdmin](./migrate.or.upgrade.iredadmin.html).
|
||||
|
||||
## Requirements
|
||||
|
||||
> iRedMail will install all required packages for you, you don't need to
|
||||
> install them manually.
|
||||
|
||||
* `Apache` 2.2+. Web server.
|
||||
|
||||
* `mod_wsgi` 2.1+. Apache module used to host Python application which supports the Python WSGI interface.
|
||||
|
||||
* `Python` 2.4+, core programming language. Warning: Python 3.x is not supported yet.
|
||||
|
||||
* `web.py`, 0.32+. A python-powered web framework.
|
||||
* `MySQLdb`: A thread-compatible interface to the popular MySQL database server that provides the Python database API. Required if you store mail accounts in OpenLDAP, MySQL or MariaDB.
|
||||
* `Python-LDAP` 2.3.7+: An object-oriented API to access LDAP directory servers from Python programs. Required if you store mail accounts in OpenLDAP.
|
||||
* `Python-psycopg2`: interface to the PostgreSQL database server from Python programs. Required if you store mail accounts in PostgreSQL.
|
||||
|
||||
## Download iRedAdmin and configure Apache web server
|
||||
|
||||
* Download iRedAdmin open source edition [here](http://www.iredmail.org/yum/misc/).
|
||||
If you're trying to install iRedAdmin-Pro, please [contact us](../contact.html)
|
||||
to get download link of iRedAdmin-Pro.
|
||||
|
||||
* Copy iRedAdmin to `/usr/local/www/`, set correct file permissions, and create symbol link.
|
||||
|
||||
```
|
||||
# tar xjf iRedAdmin-x.y.z.tar.bz2 -C /usr/local/www/
|
||||
# cd /usr/local/www/
|
||||
# chown -R iredadmin:iredadmin iRedAdmin-x.y.z
|
||||
# chmod -R 0555 iRedAdmin-x.y.z
|
||||
# ln -s iRedAdmin-x.y.z iredadmin
|
||||
```
|
||||
|
||||
* Add apache configure file: `/usr/local/etc/apache22/Includes/iredadmin.conf`:
|
||||
|
||||
```
|
||||
WSGISocketPrefix /var/run/wsgi
|
||||
WSGIDaemonProcess iredadmin user=iredadmin threads=15
|
||||
WSGIProcessGroup iredadmin
|
||||
|
||||
AddType text/html .py
|
||||
|
||||
<Directory /usr/local/www/iredadmin/>
|
||||
Order deny,allow
|
||||
Allow from all
|
||||
</Directory>
|
||||
```
|
||||
|
||||
* Edit `/usr/local/etc/apache22/extra/httpd-ssl.conf`, make iredadmin accessible via HTTPS.
|
||||
Add below lines before `</VirtualHost>`:
|
||||
|
||||
```
|
||||
WSGIScriptAlias /iredadmin /usr/local/www/iredadmin/iredadmin.py/
|
||||
Alias /iredadmin/static /usr/local/www/iredadmin/static/
|
||||
```
|
||||
|
||||
* Restart apache to enable mod_wsgi:
|
||||
|
||||
```
|
||||
# /usr/local/etc/rc.d/apache22 restart
|
||||
```
|
||||
|
||||
## Create required MySQL database and grant privileges
|
||||
|
||||
* Create MySQL database: `iredadmin`.
|
||||
|
||||
```
|
||||
# mysql -uroot -p
|
||||
mysql> CREATE DATABASE iredadmin DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
|
||||
mysql> USE iredadmin;
|
||||
mysql> SOURCE /usr/local/www/iredadmin/docs/samples/iredadmin.sql;
|
||||
```
|
||||
|
||||
* Grant privileges to iredadmin user and set password for it. WARNING: Here we
|
||||
use 'secret_passwd' as password of iredadmin user, please replace it with
|
||||
your own password.
|
||||
|
||||
```
|
||||
# mysql -uroot -p
|
||||
mysql> GRANT SELECT,INSERT,UPDATE,DELETE ON iredadmin.* TO iredadmin@localhost IDENTIFIED BY 'secret_passwd';
|
||||
mysql> FLUSH PRIVILEGES;
|
||||
```
|
||||
|
||||
## Configure iRedAdmin
|
||||
|
||||
* Copy sample config file, and make it not world-writeable.
|
||||
|
||||
* settings.py.ldap.sample: sample config file for OpenLDAP backend
|
||||
* settings.py.mysql.sample: sample config file for MySQL/MariaDB backend
|
||||
* settings.py.pgsql.sample: sample config file for PostgreSQL backend
|
||||
|
||||
```
|
||||
# cd /usr/local/www/iredadmin/
|
||||
# cp settings.py.[backend].sample settings.py
|
||||
# chown iredadmin:iredadmin settings.py
|
||||
# chmod 0400 settings.py
|
||||
```
|
||||
|
||||
* Update settings.py with correct values. Please read `settings.py` for more
|
||||
information, it's self-documented.
|
||||
|
||||
* Restart apache web server.
|
||||
|
||||
```
|
||||
# /usr/local/etc/rc.d/apache22 restart
|
||||
```
|
||||
|
||||
## Access iRedAdmin
|
||||
|
||||
Open your web browser to access iRedAdmin: `httpS://your_server_ip_address/iredadmin/`
|
||||
|
||||
Make sure you use `HTTPS://` instead of `HTTP://`.
|
||||
|
||||
## Troubleshooting & Debug
|
||||
|
||||
If iRedAdmin doesn't work as expected, you can simplily set `DEBUG = True` in
|
||||
`settings.py`, restart apache web server, use your favourite web browser to
|
||||
access it again, create a new [forum](http://www.iredmail.org/forum/) topic and
|
||||
paste error message in your forum topic.
|
||||
|
|
@ -0,0 +1,128 @@
|
|||
# Install iRedAdmin on OpenBSD
|
||||
|
||||
> This tutorial is used to install iRedAdmin from scratch, running under Apache
|
||||
> web server.
|
||||
>
|
||||
> If you already have iRedAdmin open source edition or old iRedAdmin-Pro release
|
||||
> installed, you can simply migrate it to the latest iRedAdmin by follow our short
|
||||
> tutorial: [Migrate or upgrade iRedAdmin](./migrate.or.upgrade.iredadmin.html).
|
||||
|
||||
|
||||
NOTE: This tutorial must be rewritten to use Nginx as web server since OpenBSD
|
||||
5.6 removes Apache-1.3 in base system, and Nginx will be removed since OpenBSD
|
||||
5.7.
|
||||
|
||||
## Requirements
|
||||
|
||||
> iRedMail will install all required packages for you, you don't need to
|
||||
> install them manually.
|
||||
|
||||
* `Apache` 1.3+, the built-in Apache web server in base system.
|
||||
* `Python` 2.4+, core programming language. Warning: Python 3.x is not supported yet.
|
||||
|
||||
* `web.py`, 0.32+. A python-powered web framework.
|
||||
* `MySQLdb`: A thread-compatible interface to the popular MySQL database server that provides the Python database API. Required if you store mail accounts in OpenLDAP, MySQL or MariaDB.
|
||||
* `Python-LDAP` 2.3.7+: An object-oriented API to access LDAP directory servers from Python programs. Required if you store mail accounts in OpenLDAP.
|
||||
* `Python-psycopg2`: interface to the PostgreSQL database server from Python programs. Required if you store mail accounts in PostgreSQL.
|
||||
|
||||
## Download iRedAdmin and configure Apache web server
|
||||
|
||||
* Download iRedAdmin open source edition [here](http://www.iredmail.org/yum/misc/).
|
||||
If you're trying to install iRedAdmin-Pro, please [contact us](../contact.html)
|
||||
to get download link of iRedAdmin-Pro.
|
||||
|
||||
* Copy iRedAdmin to `/var/www/`, set correct file permissions, and create symbol link.
|
||||
|
||||
```
|
||||
# tar xjf iRedAdmin-x.y.z.tar.bz2 -C /var/www/
|
||||
# cd /var/www/
|
||||
# chown -R iredadmin:iredadmin iRedAdmin-x.y.z
|
||||
# chmod -R 0555 iRedAdmin-x.y.z
|
||||
# ln -s iRedAdmin-x.y.z iredadmin
|
||||
```
|
||||
|
||||
* Add apache configure file: `/var/www/conf/modules/iredadmin.conf`.
|
||||
|
||||
```
|
||||
AddType text/html .py
|
||||
AddHandler cgi-script .py
|
||||
|
||||
<Directory /var/www/iredadmin/>
|
||||
Options +ExecCGI
|
||||
Order deny,allow
|
||||
Allow from all
|
||||
</Directory>
|
||||
```
|
||||
|
||||
* Edit `/var/www/conf/httpd.conf`, make iredadmin accessible via HTTPS.
|
||||
Add below lines before `</VirtualHost>`:
|
||||
|
||||
```
|
||||
Alias /iredadmin/static /var/www/iredadmin/static
|
||||
ScriptAlias /iredadmin /var/www/iredadmin/iredadmin.py
|
||||
```
|
||||
|
||||
* Restart apache to enable mod_wsgi:
|
||||
|
||||
```
|
||||
# /etc/rc.d/httpd restart
|
||||
```
|
||||
|
||||
## Create required MySQL database and grant privileges
|
||||
|
||||
* Create MySQL database: `iredadmin`.
|
||||
|
||||
```
|
||||
# mysql -uroot -p
|
||||
mysql> CREATE DATABASE iredadmin DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
|
||||
mysql> USE iredadmin;
|
||||
mysql> SOURCE /var/www/iredadmin/docs/samples/iredadmin.sql;
|
||||
```
|
||||
|
||||
* Grant privileges to iredadmin user and set password for it. WARNING: Here we
|
||||
use 'secret_passwd' as password of iredadmin user, please replace it with
|
||||
your own password.
|
||||
|
||||
```
|
||||
# mysql -uroot -p
|
||||
mysql> GRANT SELECT,INSERT,UPDATE,DELETE ON iredadmin.* TO iredadmin@localhost IDENTIFIED BY 'secret_passwd';
|
||||
mysql> FLUSH PRIVILEGES;
|
||||
```
|
||||
|
||||
## Configure iRedAdmin
|
||||
|
||||
* Copy sample config file, and make it not world-writeable.
|
||||
|
||||
* settings.py.ldap.sample: sample config file for OpenLDAP backend
|
||||
* settings.py.mysql.sample: sample config file for MySQL/MariaDB backend
|
||||
* settings.py.pgsql.sample: sample config file for PostgreSQL backend
|
||||
|
||||
```
|
||||
# cd /var/www/iredadmin/
|
||||
# cp settings.py.[backend].sample settings.py
|
||||
# chown iredadmin:iredadmin settings.py
|
||||
# chmod 0400 settings.py
|
||||
```
|
||||
|
||||
* Update settings.py with correct values. Please read `settings.py` for more
|
||||
information, it's self-documented.
|
||||
|
||||
* Restart apache web server.
|
||||
|
||||
```
|
||||
# /etc/rc.d/httpd restart
|
||||
```
|
||||
|
||||
## Access iRedAdmin
|
||||
|
||||
Open your web browser to access iRedAdmin: `httpS://your_server_ip_address/iredadmin/`
|
||||
|
||||
Make sure you use `HTTPS://` instead of `HTTP://`.
|
||||
|
||||
## Troubleshooting & Debug
|
||||
|
||||
If iRedAdmin doesn't work as expected, you can simplily set `DEBUG = True` in
|
||||
`settings.py`, restart apache web server, use your favourite web browser to
|
||||
access it again, create a new [forum](http://www.iredmail.org/forum/) topic and
|
||||
paste error message in your forum topic.
|
||||
|
|
@ -0,0 +1,127 @@
|
|||
# Install iRedAdmin on Red Hat Enterprise Linux, CentOS, Scientific Linux
|
||||
|
||||
> This tutorial is used to install iRedAdmin from scratch, running under Apache
|
||||
> web server.
|
||||
>
|
||||
> If you already have iRedAdmin open source edition or old iRedAdmin-Pro release
|
||||
> installed, you can simply migrate it to the latest iRedAdmin by follow our short
|
||||
> tutorial: [Migrate or upgrade iRedAdmin](./migrate.or.upgrade.iredadmin.html).
|
||||
|
||||
## Requirements
|
||||
|
||||
> iRedMail will install all required packages for you, you don't need to
|
||||
> install them manually.
|
||||
|
||||
* `Apache` 2.2+. Web server.
|
||||
|
||||
* `mod_wsgi` 2.1+. Apache module used to host Python application which supports the Python WSGI interface.
|
||||
|
||||
* `Python` 2.4+, core programming language. Warning: Python 3.x is not supported yet.
|
||||
|
||||
* `web.py`, 0.32+. A python-powered web framework.
|
||||
* `MySQLdb`: A thread-compatible interface to the popular MySQL database server that provides the Python database API. Required if you store mail accounts in OpenLDAP, MySQL or MariaDB.
|
||||
* `Python-LDAP` 2.3.7+: An object-oriented API to access LDAP directory servers from Python programs. Required if you store mail accounts in OpenLDAP.
|
||||
* `Python-psycopg2`: interface to the PostgreSQL database server from Python programs. Required if you store mail accounts in PostgreSQL.
|
||||
|
||||
## Download iRedAdmin and configure Apache web server
|
||||
|
||||
* Download iRedAdmin open source edition [here](http://www.iredmail.org/yum/misc/).
|
||||
If you're trying to install iRedAdmin-Pro, please [contact us](../contact.html)
|
||||
to get download link of iRedAdmin-Pro.
|
||||
|
||||
* Copy iRedAdmin to `/var/www/`, set correct file permissions, and create symbol link.
|
||||
|
||||
```
|
||||
# tar xjf iRedAdmin-x.y.z.tar.bz2 -C /var/www/
|
||||
# cd /var/www/
|
||||
# chown -R iredadmin:iredadmin iRedAdmin-x.y.z
|
||||
# chmod -R 0555 iRedAdmin-x.y.z
|
||||
# ln -s iRedAdmin-x.y.z iredadmin
|
||||
```
|
||||
|
||||
* Add apache configure file: `/etc/httpd/conf.d/iredadmin.conf`:
|
||||
|
||||
```
|
||||
WSGISocketPrefix /var/run/wsgi
|
||||
WSGIDaemonProcess iredadmin user=iredadmin threads=15
|
||||
WSGIProcessGroup iredadmin
|
||||
|
||||
AddType text/html .py
|
||||
|
||||
<Directory /var/www/iredadmin/>
|
||||
Order deny,allow
|
||||
Allow from all
|
||||
</Directory>
|
||||
```
|
||||
|
||||
* Edit `/etc/httpd/conf.d/ssl.conf`, make iredadmin accessible via HTTPS.
|
||||
Add below lines before `</VirtualHost>`:
|
||||
|
||||
```
|
||||
WSGIScriptAlias /iredadmin /var/www/iredadmin/iredadmin.py/
|
||||
Alias /iredadmin/static /var/www/iredadmin/static/
|
||||
```
|
||||
|
||||
* Restart apache to enable mod_wsgi:
|
||||
|
||||
```
|
||||
# /etc/init.d/httpd restart
|
||||
```
|
||||
|
||||
## Create required MySQL database and grant privileges
|
||||
|
||||
* Create MySQL database: `iredadmin`.
|
||||
|
||||
```
|
||||
# mysql -uroot -p
|
||||
mysql> CREATE DATABASE iredadmin DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
|
||||
mysql> USE iredadmin;
|
||||
mysql> SOURCE /var/www/iredadmin/docs/samples/iredadmin.sql;
|
||||
```
|
||||
|
||||
* Grant privileges to iredadmin user and set password for it. WARNING: Here we
|
||||
use 'secret_passwd' as password of iredadmin user, please replace it with
|
||||
your own password.
|
||||
|
||||
```
|
||||
# mysql -uroot -p
|
||||
mysql> GRANT SELECT,INSERT,UPDATE,DELETE ON iredadmin.* TO iredadmin@localhost IDENTIFIED BY 'secret_passwd';
|
||||
mysql> FLUSH PRIVILEGES;
|
||||
```
|
||||
|
||||
## Configure iRedAdmin
|
||||
|
||||
* Copy sample config file, and make it not world-writeable.
|
||||
|
||||
* settings.py.ldap.sample: sample config file for OpenLDAP backend
|
||||
* settings.py.mysql.sample: sample config file for MySQL/MariaDB backend
|
||||
* settings.py.pgsql.sample: sample config file for PostgreSQL backend
|
||||
|
||||
```
|
||||
# cd /var/www/iredadmin/
|
||||
# cp settings.py.[backend].sample settings.py
|
||||
# chown iredadmin:iredadmin settings.py
|
||||
# chmod 0400 settings.py
|
||||
```
|
||||
|
||||
* Update settings.py with correct values. Please read `settings.py` for more
|
||||
information, it's self-documented.
|
||||
|
||||
* Restart apache web server.
|
||||
|
||||
```
|
||||
# /etc/init.d/httpd restart
|
||||
```
|
||||
|
||||
## Access iRedAdmin
|
||||
|
||||
Open your web browser to access iRedAdmin: `httpS://your_server_ip_address/iredadmin/`
|
||||
|
||||
Make sure you use `HTTPS://` instead of `HTTP://`.
|
||||
|
||||
## Troubleshooting & Debug
|
||||
|
||||
If iRedAdmin doesn't work as expected, you can simplily set `DEBUG = True` in
|
||||
`settings.py`, restart apache web server, use your favourite web browser to
|
||||
access it again, create a new [forum](http://www.iredmail.org/forum/) topic and
|
||||
paste error message in your forum topic.
|
|
@ -2,12 +2,19 @@
|
|||
|
||||
[TOC]
|
||||
|
||||
## Upgrade iRedAdmin-Pro
|
||||
## Upgrade iRedAdmin
|
||||
|
||||
With the latest iRedAdmin-Pro, you can simply upgrade old releases by following
|
||||
With the latest iRedAdmin, you can simply upgrade old releases by following
|
||||
this tutorial with just one shell command:
|
||||
[Migrate or upgrade iRedAdmin](./migrate.or.upgrade.iredadmin.html)
|
||||
|
||||
## Install iRedAdmin
|
||||
|
||||
* [Install iRedAdmin on Red Hat Enterprise Linux, CentOS, Scientific Linux](./install.iredadmin.on.rhel.html)
|
||||
* [Install iRedAdmin on Debian, Ubuntu](./install.iredadmin.on.debian.html)
|
||||
* [Install iRedAdmin on FreeBSD](./install.iredadmin.on.freebsd.html)
|
||||
* [Install iRedAdmin on OpenBSD](./install.iredadmin.on.openbsd.html)
|
||||
|
||||
## Release Notes
|
||||
|
||||
### iRedAdmin-Pro-LDAP (for OpenLDAP backend)
|
||||
|
|
Loading…
Reference in New Issue