{"id":6668,"date":"2018-09-10T17:51:15","date_gmt":"2018-09-10T13:51:15","guid":{"rendered":"https:\/\/www.howtoforge.com\/tutorial\/ispconfig-3-roundcube-plugins-on-debian-stretch\/"},"modified":"2018-09-10T17:51:15","modified_gmt":"2018-09-10T13:51:15","slug":"ispconfig-3-roundcube-plugin-on-debian-9-stretch","status":"publish","type":"post","link":"https:\/\/afaghhosting.net\/blog\/ispconfig-3-roundcube-plugin-on-debian-9-stretch\/","title":{"rendered":"ISPConfig 3 Roundcube Plugin on Debian 9 (Stretch)"},"content":{"rendered":"<ul>\n<li>Operating system version: Debian 9.4 and 9.5 Stretch<\/li>\n<li>Roundcube version: 1.2.3+dfsg.1-4+deb9u1 and u2<\/li>\n<li>ISPConfig 3 version: 3.1.11 and 3.1.13<\/li>\n<\/ul>\n<p>This howto is based on ISPConfig3_roundcube Installation Instructions from <a href=\"https:\/\/github.com\/w2c\/ispconfig3_roundcube\/wiki\/Installation-Instructions-(manual)\" target=\"_blank\" rel=\"noopener\">Manual<\/a>.<\/p>\n<h2 id=\"prerequisites\">Prerequisites<\/h2>\n<p>Use the Roundcube version that comes with Debian 9, install it as instructed in the <a href=\"https:\/\/www.howtoforge.com\/tutorial\/perfect-server-debian-9-stretch-apache-bind-dovecot-ispconfig-3-1\/\" target=\"_blank\" rel=\"noopener\">Perfect Server Guide for Debian Stretch<\/a>.<\/p>\n<p>Use current ISPConfig, now latest is version 3.1.13.<\/p>\n<h2 id=\"add-ispconfig-remote-user\">Add ISPConfig Remote User<\/h2>\n<p>Add ISPConfig remote user for Roundcube use. Choose a suitable name, I use <b>rcmail-remote<\/b>. Choose a good password, I usually generate passwords with <b>apg<\/b>, do <b>apt-get install apg<\/b> first.<\/p>\n<p class=\"command\">apg -m 12 -l M NCL<\/p>\n<p>Create the remote user in ISPConfig Panel, tab <b>System<\/b>, under User Management is &#8220;Remote Users&#8221;. Click &#8220;Add new user&#8221; -button.<\/p>\n<p>I did not tick <b>Remote Access:<\/b>, my setup has separate e-mail server where mail files and Roundcube and Dovecot are installed. So even though this is &#8220;remote user&#8221; it does not need remote access in my case.<\/p>\n<p>For this user choose:<\/p>\n<pre>- Server functions&#13;\n- Client functions&#13;\n- Mail user functions&#13;\n- Mail alias functions&#13;\n- Mail spamfilter user functions&#13;\n- Mail spamfilter policy functions&#13;\n- Mail fetchmail functions&#13;\n- Mail spamfilter whitelist functions&#13;\n- Mail spamfilter blacklist functions&#13;\n- Mail user filter functions&#13;\n<\/pre>\n<p>That list is in the order the items appear in ISPConfig Panel.<\/p>\n<h2 id=\"install-ispconfig-roundcube-plugin\">Install ISPConfig RoundCube Plugin<\/h2>\n<p>Fetch the ISPConfig3-plugins from Github. I used latest version for RoundCube 1.2.3. The plugin author writes in the manual to check out from Subversion directly to RoundCube root directory. I prefer to check out elsewhere, so I do not mess up the system directory where apt-get installs files.<\/p>\n<p>The Readme.Debian in \/usr\/share\/doc\/roundcube advices to &#8220;Add your plugin in \/var\/lib\/roundcube\/plugins.&#8221;. I checkout from svn to \/root\/ISPConfig3_plugins and copy from there to \/var\/lib\/roundcube\/plugins. The plugins from Debian packages are installed in \/usr\/share\/roundcube and there is a symbolic link to those from \/var\/lib\/roundcube\/plugins. Install Subversion to get command <b>svn<\/b>. (apt-get install subversion).<\/p>\n<p class=\"command\">cd \/root<br \/>mkdir ISPConfig3_plugins<br \/>cd ISPConfig3_plugins<br \/>svn co https:\/\/github.com\/w2c\/ispconfig3_roundcube\/trunk\/ .<\/p>\n<p class=\"command\">cd ispconfig3_account\/config<br \/>cp config.inc.php.dist config.inc.php<\/p>\n<h2 id=\"configure-plugin\">Configure Plugin<\/h2>\n<p>Edit the file copied at last command of previous command lines. Fill in the remote user info created in Step 2.<\/p>\n<p class=\"command\">cd \/root\/ISPConfig3_plugins<\/p>\n<p class=\"command\">editor ispconfig3_account\/config\/config.inc.php<\/p>\n<p>Original file looks like this:<\/p>\n<pre>&lt;?php&#13;\n$rcmail_config['identity_limit'] = false;&#13;\n$rcmail_config['remote_soap_user'] = 'roundcube';&#13;\n$rcmail_config['remote_soap_pass'] = 'roundcube';&#13;\n$rcmail_config['soap_url'] = 'http:\/\/192.177.167.44:8080\/remote\/';&#13;\n?&gt;&#13;\n<\/pre>\n<p>Change the remote_soap_user, remote_soap_pass (user and pass created in Step 2) and soap_url. If you use ISPConfig panel with <a href=\"https:\/\/www.howtoforge.com\" target=\"_blank\" rel=\"noopener\">https:\/\/<\/a>, use the same here for soap_url. You can use IP-address or hostname and domain in soap_url. Port number is the same as for ISPConfig panel.<\/p>\n<h2 id=\"activate-plugin\">Activate Plugin<\/h2>\n<p>Edit Roundcube configuration, in file \/etc\/roundcube\/config.inc.php. Search for &#8220;List of active plugins&#8221;. Debian Stretch does not enable any plugins by default, so the list is empty unless you have already enabled some plugins. If the list is empty, i.e. looks like this:<\/p>\n<pre>\/\/ List of active plugins (in plugins\/ directory)&#13;\n\/\/ Debian: install roundcube-plugins first to have any&#13;\n$config['plugins'] = array(&#13;\n);&#13;\n<\/pre>\n<p>just replace it with this:<\/p>\n<pre>$config['plugins'] = array(&#13; \"jqueryui\",\"ispconfig3_account\", \"ispconfig3_autoreply\", &#13; \"ispconfig3_autoselect\", \"ispconfig3_pass\", \"ispconfig3_spam\", &#13; \"ispconfig3_fetchmail\", \"ispconfig3_filter\", &#13; \"ispconfig3_forward\", \"ispconfig3_wblist\"&#13;\n);&#13;\n<\/pre>\n<p>The order of plugins is important! Do not change the order unless you know what you are doing.<\/p>\n<p>If it was non-empty, add the ISPConfig3 plugins after the existing plugins. If some plugin is not needed, remove it from the list and it is no longer enabled.<\/p>\n<p>If you are using only one mail host, do remove the ispconfig3_autoselect plugin, since you do not need it that case and it creates just problems if you fail to configure it properly.<\/p>\n<p>I removed ispconfig3_forward because I noticed errors in \/var\/log\/roundcube\/errors for line 135 in file ispconfig3_forward\/ispconfig3_forward.php.<\/p>\n<h2 id=\"copy-plugin-to-system-location\">Copy Plugin to system location<\/h2>\n<p>Now you must copy the plugins from the checkout directory to \/var\/lib\/roundcube. Do it for example like this:<\/p>\n<p class=\"command\">cd \/root\/ISPConfig3_plugins<br \/>for f in ispconfig3_* ; do echo $f ; cp &#8211;recursive $f \/var\/lib\/roundcube\/plugins\/ ; done<\/p>\n<h2 id=\"testing\">Testing<\/h2>\n<p>If the new Plugins are shown in Settings, but clicking them pops up error message &#8220;Soap Error: Not Found&#8221; or &#8220;Soap Error: Bad Request&#8221; check the soap_url setting. Maybe it is missing slash character &#8220;\/&#8221; at the end.<\/p>\n<p>Test and enjoy. There is a 5th item in the Settings menu created by these plugins.<\/p>\n<p><a class=\"fancybox\" id=\"img-Roundcube_account_autoreply\" href=\"https:\/\/www.howtoforge.com\/images\/ispconfig_3_roundcube_plugins_on_debian_stretch\/big\/Roundcube_account_autoreply.png\" target=\"_blank\" rel=\"noopener\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/ispconfig-3-roundcube-plugin-on-debian-9-stretch.png\" alt=\"RoundCube account\" width=\"550\" height=\"471\" title=\"\"><\/a><\/p>\n<p>If you get errors, read Troubleshooting FAQ by ISPConfig3 plugins author from https:\/\/github.com\/w2c\/ispconfig3_roundcube\/wiki\/Troubleshooting&#8212;FAQ. If that does not help, read logs from <span class=\"system\">\/var\/log\/roundcube\/errors<\/span>. If you still have problems, see other logs in <span class=\"system\">\/var\/log<\/span> and <span class=\"system\">\/var\/log\/apache2<\/span> directories. If nothing helps, check you have installed the server according to the Perfect Server Guide. I have been told the VM image does not have php-soap installed, and the ISPConfig installed by script also lacks this PHP package.<\/p>\n<div>\n<p><b>Share this page:<\/b><\/p>\n<p>\n<a href=\"https:\/\/www.facebook.com\/sharer.php?u=https%3A%2F%2Fwww.howtoforge.com%2Ftutorial%2Fispconfig-3-roundcube-plugins-on-debian-stretch%2F\" target=\"_blank\" rel=\"nofollow noopener noreferrer\"><img decoding=\"async\" src=\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/ispconfig-3-roundcube-plugin-on-debian-9-stretch-1.png\" height=\"20\" alt=\"\" title=\"\"><\/a><br \/>\n<a href=\"https:\/\/twitter.com\/intent\/tweet?url=https%3A%2F%2Fwww.howtoforge.com%2Ftutorial%2Fispconfig-3-roundcube-plugins-on-debian-stretch%2F&amp;text=ISPConfig+3+Roundcube+Plugin+on+Debian+9+%28Stretch%29&amp;via=howtoforgecom&amp;related=howtoforgecom\" target=\"_blank\" rel=\"nofollow noopener noreferrer\"><img decoding=\"async\" src=\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/ispconfig-3-roundcube-plugin-on-debian-9-stretch-2.png\" height=\"20\" alt=\"\" title=\"\"><\/a><br \/>\n<a href=\"https:\/\/twitter.com\/howtoforgecom\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\"><img decoding=\"async\" src=\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/ispconfig-3-roundcube-plugin-on-debian-9-stretch-3.png\" height=\"20\" alt=\"\" title=\"\"><\/a><br \/>\n<a href=\"https:\/\/plus.google.com\/share?url=https%3A%2F%2Fwww.howtoforge.com%2Ftutorial%2Fispconfig-3-roundcube-plugins-on-debian-stretch%2F\" target=\"_blank\" rel=\"nofollow noopener noreferrer\"><img decoding=\"async\" src=\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/ispconfig-3-roundcube-plugin-on-debian-9-stretch-4.png\" height=\"20\" alt=\"\" title=\"\"><\/a>\n<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Operating system version: Debian 9.4 and 9.5 Stretch Roundcube version: 1.2.3+dfsg.1-4+deb9u1 and u2 ISPConfig 3 version: 3.1.11 and 3.1.13 This howto is based on ISPConfig3_roundcube Installation Instructions from Manual. Prerequisites Use the Roundcube version that comes with Debian 9, install it as instructed in the Perfect Server Guide for Debian Stretch. Use current ISPConfig, now [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[36],"tags":[],"class_list":["post-6668","post","type-post","status-publish","format-standard","hentry","category-36"],"_links":{"self":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts\/6668","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/comments?post=6668"}],"version-history":[{"count":0,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts\/6668\/revisions"}],"wp:attachment":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/media?parent=6668"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/categories?post=6668"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/tags?post=6668"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}