oscartheduckin’ around

April 25, 2007

Session Cache is not configured [hint: SSLSessionCache] — freebsd

Filed under: apache, freebsd — oscartheduck @ 9:33 pm

Note: since this blog post was written, it has received about 250 hits a month by itself from random google searches. If it does not solve your issue, please please write up your solution on your own wordpress blog and pop a link in the comments, or just write it up here.

I’ve encountered this one a fair few times.

The problem, for me, is that this is a misleading error message. It makes you think about SSL, about something to do with caching, about anything, in fact, other than what the problem is. As such, I’ve spent frustrating HOURS sitting around googling reading about changing apache’s ssl stuff to this and that and the other thing, when none of them are the answer.

Okay, the problem is this: you haven’t configured DNS correctly. That simple. Your machine is, for some reason, unable to resolve your machine name correctly.

The solution here is for FreeBSD, but now you’ve got an idea of what the problem actually seems to be you might be able to fix it.

For FreeBSD:

first, edit /etc/hosts and enter your ip address, machine name and domain name.

For me, because I’m privately addressed and have no domain name for the machine, I did this underneath the line about localhost: pigeon pigeon.my.domain

Then save that sucker.

Next, use the hostname command to change your host name:

hostname pigeon.my.domain

Great, almost there.

To not have to type the above command in every stinking time the machine reboots, enter:


into /etc/rc.conf

Finally, change the line that reads something like:


in /usr/local/etc/apache22/httpd.conf to read something like

ServerName pigeon.my.domain

Now do an apachectl restart and bob’s your mother’s brother, everything’s tickety boo!



  1. Hmm… I thought I knew about computers until I read the above, which might as well be written in Chinese. 😦

    Windows has obviously made me stupid. Damn you Bill Gates!

    Comment by Robert Hampton — April 29, 2007 @ 10:02 pm

  2. It’ll do that (Windows => stupid, I mean). Thanks for the how-to Oscar…fixed me right up.

    Comment by Nate Mow — January 3, 2008 @ 12:07 am

  3. In Windows the error message disappeared after I copied the SSLSessionCache directive from to httpd-ssl.conf to httpd.conf, as pointed out in a post related to Bug 23403 at apache.org.

    Comment by Toivo Talikka — April 24, 2008 @ 12:30 am

  4. The real reason for the error was that my httpd.conf had the line:

    #Include conf/extra/httpd-ssl.conf

    As soon as I uncommented that line and moved the SSLSessionCache directive to httpd-ssl.conf, Apache started normally.

    Comment by Toivo Talikka — April 24, 2008 @ 12:50 am

  5. […] “Session Cache is not configured [hint: SSLSessionCache]” got me to this page, where I learned all I need to know about about telling your server who it is.  (”You […]

    Pingback by Cascadia BIT » Blog Archive » A failure of DNS — September 17, 2008 @ 1:38 am

  6. Thanks Toivo,

    >As soon as I uncommented that line and moved the SSLSessionCache directive to httpd-ssl.conf, Apache started normally.

    That was it!

    Comment by Ukb — September 30, 2008 @ 5:15 pm

  7. This material got rid of:
    Session Cache is not configured [hint: SSLSessionCache].

    Now, on to the “premature ending of the script headers.”

    Comment by Joe Doll — October 16, 2008 @ 5:15 pm

  8. thx a 1000 times. took me the hole day to find this side ^^

    Comment by marcmoe — January 23, 2009 @ 9:29 pm

  9. thanx allot man
    really amazing
    now its working 😉

    Comment by smooth — January 29, 2009 @ 12:41 pm

  10. I uncommented…
    Include conf/extra/httpd-ssl.conf
    then: add certificare with openssl “server.crt” into /usr/local/etc/apache22/
    then OK apachectl stop/start 🙂

    Comment by wmoreno3 — February 14, 2009 @ 6:45 am

  11. It is an common issue when your ssl configuration can not load.
    Confirm that
    [ include conf/ssl.conf ] is properly setup in your httpd.conf file.

    Comment by Sohel Taslim — August 25, 2009 @ 10:18 am

  12. Thanky you very much. Ive been looking everywhere trying to find out why my server wasnt starting and you are right. It was just a dns issue. Once I followed your instructions everything started working. A million thanks. I will be reading more of your website. You kick ass!!

    Comment by Michael — January 2, 2010 @ 8:12 am

  13. Thank you very much!!!

    Comment by gena — February 19, 2010 @ 8:28 am

  14. I do get an error about not having the domain name set up, but since I have multiple interfaces I couldn’t figure out how to do it with /etc/hosts

    I found you could get rid of that using httpd.conf’s ServerName, but that it didn’t fix the problem

    I found that I had to remove the www user (whos home directory I had changed recently) and remove my httpd.conf and accept the new one, then change the new one rather than try and reuse the old one.

    Once I did this it started working again; basically a reinstall and reconfigure.

    It may be because I had been reusing the same conf since 2.0 and it finally stopped liking that, but yeah flushing out the config and starting from the default worked here

    Comment by kestasjk — May 8, 2010 @ 5:13 am

  15. […] Session Cache is not configured [hint: SSLSessionCache] — freebsd « oscartheduckin’ around […]

    Pingback by Qmail on Centos 5.5 w/updates – “almost” working « CrappyServerScripts.info — September 6, 2010 @ 9:41 pm

  16. On FreeBSD I fixed this by verifying the openSSL was enabled in php5-extensions using steps below

    cd /usr/ports/lang/php5-extensions
    make config
    (make sure OPENSSL is checked)
    make && make deinstall && make reinstall

    Comment by ls4680 — December 27, 2010 @ 4:01 am

  17. None of this makes any sence at all…Although this may fix the problem for some it is VERY poorly written. I have no folder ect/host and considering apache and Xampp have hundreds of files this isnt helpful…If anything you have confused and pissed me off more then what I was. More useless results for me on a Three days search…

    Comment by whatever — February 24, 2013 @ 1:51 am

RSS feed for comments on this post. TrackBack URI

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

Blog at WordPress.com.

%d bloggers like this: