| Important note: Some information on this page may be outdated. This note will be removed if the content has been verified to apply to the 1.0 release.
Most of the documentation on this site (and thus, this page) applies to 1.0. By far the most important change is that opencli is now called openpanel-cli.
Frequently Asked Questions (FAQ)
Frequently asked questions are prefixed with an "Q:" (question). Likely errors are prefixed with an "E:" (error) and describe the type of error, the specific error message has a deeper heading.
Q: "Should I install this software on a live / production server?"
A: "Not if it's on a server that already running and critical, but.."
There is no problem in installing it on a vanilla system, and using this setup for production.
E: Broken packages
Depends: openpanel-mod-postfixcourier but it is not going to be installed
Use aptitude to install your OpenPanel packages. It will offer to deinstall exim for you.
E: Errors were encountered while processing: openpanel-mod-ftp
If you are on an OpenVZ VPS, check out 
E: Connection refused
The server does not respond at port 4089
(Re)start the openpanel-ssl service
# /etc/init.d/openpaneld restart
This is wrong as the openpaneld service no longer exists in the latest version
E: "The connection to <server>:4089 was interrupted"
using "curl https://localhost:4089 -kv" I retrieved the error:
# curl: (35) Unknown SSL protocol error in connection to 22.214.171.124:4089
E: How can I view the logs of connection attempts to the openpanel gui
# waiting to find out, but none of the log files in /var/openpanel/log seem to say anything
E: 404 Not Found
Is openpanel-gui installed?
E: Login failed
login onto the imap/pop3/ftp/etc server failed
Perhaps contrary to what you're used to: accounts always have the extension "@domainname" attached to them. So if you add a user john to the domain foo.com it's login for the imap emailbox is "firstname.lastname@example.org" the same applies for example for ftp-accounts.
E: No route to host / service
Make sure the appropriate ports are not blocked by for example a firewall
Openpanel hosting for django
Make sure you have mod_python enabled. For debian and ubuntu:
sudo apt-get install libapache2-mod-python sudo a2enmod python
Open your website's openpanel inc directory to store your configuration directives. In my case
If you want to server static content (django /static),let apache do it by add the following
Alias /static/ /home/penguins/web/www.yoursite.co.ke/django/static/ <Directory "/home/penguins/web/www.yoursite.co.ke/django/static/"> AllowOverride None Order allow,deny Allow from all </Directory> #Don't let django do it's magic <Location "/static"> SetHandler None </Location> #Serving the actual site <Location "/"> SetHandler python-program PythonHandler django.core.handlers.modpython SetEnv DJANGO_SETTINGS_MODULE YOURPROJECTNAME.settings PythonPath "['/home/penguins/web/www.yoursite.co.ke/'] + sys.path" PythonDebug On </Location>
Reload apache and you are good to go
I found lots of tutorials on the net about how to do this and I found myself in a very sticky situation, people recommended using dovecot for SASL, then I found another which said to use cyrus, etc, etc, basically, it's much much easier than that.
- open a ssh connection to your server
- login as root, or use sudo, cause you're going to execute commands to alter the system
- apt-get install courier-pop-ssl
- open your browser and navigate to your openpanel gui installation
- login and open the firewall
- add port 995, call it something like encrypted pop3, use TCP protocol
- edit /etc/postfix/main.cf
- remove the entry which says "smtp_use_tls", just delete the line
- add a new line, type: smtp_tls_security_level = may
- save the file and run /etc/init.d/postfix restart
OpenPanel: editing email account "failed to open userdb.dat"
I once found that you can sometimes follow the wrong tutorial and break stuff without realising it. One thing I broke was I ran postmap userdb and it output a Berkerley DB formatted userdb, which I then used as userdb.dat, I did this because a tutorial told me that if you see in the logs that one file is out of date and the other file is newer, to do it, I realised afterwards this was a bad idea(tm).
It was very stupid, but I didnt understand at the time.
userdb.dat should be in GDBM format, not Berkerley format, if you happen to also make this mistake, do this to correct it:
- makedat -src=userdb -file=userdb.dat -tmp=x
- chown openpanel-core openpanel-core userdb.dat
now try editing the email account, it should work without a fault.