How do I start Hunchentoot?

Question

How do I start Hunchentoot on a project? I looked over Edi Weitz's guide and everything went smoothly until after installation. The listed tutorials were either broken or skimmed over actual server usage.

I have my asdf file, installed dependencies with quicklisp, and set up a dispatch table. How do I get Hunchentoot to work with this stuff?

http://weitz.de/hunchentoot/#start like so? – Nov 02 '13 at 15:20 — , Nov 02 '13 at 15:20

score 3 · Answer 1 · answered Oct 23 '17 at 22:31

To update, I've improved upon Svante's answer:

(defun start-server ()
  (stop-server)
  (start (setf *acceptor*
               (make-instance 'easy-acceptor
                              :port 4242))))

(defun stop-server ()
  (when *acceptor*
    (when started-p *acceptor*
     (stop *acceptor*))))

Prior to starting the server, acceptor is nil. After the server has been started (even if it has subsequently been stopped) it is no longer nil. The started-p test checks to see if an initialized easy-acceptor is started. If you try to stop an already stopped acceptor, you receive an error.

Svante · Answer 2 · 2017-09-13T19:44:56.053

You invoke start on an instance of an acceptor.

If you use the basic easy-handler mechanism that comes with hunchentoot, that would be an easy-acceptor.

You will want to have a mechanism in place to start and stop your server. That might look like this:

(defvar *acceptor* nil)

(defun start-server ()
  (stop-server)
  (start (setf *acceptor*
               (make-instance 'easy-acceptor
                              :port 4242))))

(defun stop-server ()
  (when *acceptor*
    (stop *acceptor*)))

score 0 · Answer 3 · edited Sep 11 '17 at 20:18

0

(start (defparameter hunchentoot-listener
         (make-instance 'easy-acceptor
                        :port 4242
                        :document-root #p"/path/to/your/html/")))

will get you a running web server on port 4242 (http://localhost:4242/)

edited Sep 11 '17 at 20:18

Svante

50,694
11
78
122

answered Sep 11 '17 at 00:49

JEPrice

627
7
10

1

Don't use `defparameter` like that. You want your toplevel forms to be reloadable. – Svante Sep 11 '17 at 20:16
I'm still on the up slope of the learning curve - can you give an example of a more acceptable way? – JEPrice Sep 13 '17 at 03:30
I added an example to my answer. – Svante Sep 13 '17 at 19:53

How do I start Hunchentoot?

3 Answers3