From Openpanel Documentation Wiki
Jump to: navigation, search
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 [1]


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

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 "john@foo.com" 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

     #Don't let django do it's magic

    <Location "/static">
        SetHandler None

    #Serving the actual site
    <Location "/">
       SetHandler python-program
       PythonHandler django.core.handlers.modpython
       PythonPath "['/home/penguins/web/www.yoursite.co.ke/'] + sys.path"
       PythonDebug On

Reload apache and you are good to go


Encrypted Email

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.

  1. open a ssh connection to your server
  2. login as root, or use sudo, cause you're going to execute commands to alter the system
  3. apt-get install courier-pop-ssl
  4. open your browser and navigate to your openpanel gui installation
  5. login and open the firewall
  6. add port 995, call it something like encrypted pop3, use TCP protocol
  7. edit /etc/postfix/main.cf
  8. remove the entry which says "smtp_use_tls", just delete the line
  9. add a new line, type: smtp_tls_security_level = may
  10. 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:

  1. makedat -src=userdb -file=userdb.dat -tmp=x
  2. chown openpanel-core openpanel-core userdb.dat

now try editing the email account, it should work without a fault.

Personal tools