Project

General

Profile

Debian Wiki page for Lighttpd

Added by CCormier over 3 years ago

Hi! I've become a huge fan of Lighttpd recently after trying it out on one of my servers. I've written a page on the Debian Wiki attempting to document it, especially for where the Debian package might differ from the official wiki in terms of setup.

If anyone's interested and has some thoughts, I'd like to hopefully get feedback on it, because I'm sure I've made some mistakes or omissions. Any suggestions for what else it should cover, or any formatting changes I could make, would also be appreciated. Thanks! :)

https://wiki.debian.org/Lighttpd


Replies (8)

RE: Debian Wiki page for Lighttpd - Added by gstrauss over 3 years ago

Nice! Thank you for doing that. I'll take a closer read later this evening.

> SSL/TTS is strongly recommended in all cases
      ~~~

I think that should be "TLS"

I've been reviewing the documentation on this site, too, so if you have any feedback about the info at https://wiki.lighttpd.net/ that is appreciated, too. There is a lot of doc to review on this site, so if you have a favorite page or two which could use some polishing, please suggest it here.

RE: Debian Wiki page for Lighttpd - Added by gstrauss over 3 years ago

The Docs_Performance page was recently updated, and the debian page points to a no-longer existing page Docs_MultiProcessor. Instead, please see server.max-worker

The Debian wiki text copies some older text from this site, and the older text has been removed.

"This is not recommended as it breaks several important features, most notably the access log. Nonetheless, it's documented on the Lighttpd wiki: https://redmine.lighttpd.net/projects/lighttpd/wiki/Docs_MultiProcessor"

That is no longer accurate. The access log works, even with multiple workers. Multiple workers do not "break several important features", though there are limitations that are documented in server.max-worker

RE: Debian Wiki page for Lighttpd - Added by gstrauss over 3 years ago

I am not convinced that the "MIME types" section in https://wiki.debian.org/Lighttpd should be there at all. Most people, especially beginners, should not change these settings, as the defaults work well for most uses. Therefore, the "MIME types" section presence on the page adds more confusion for beginners, and does not add value to the page. Just my opinion.

RE: Debian Wiki page for Lighttpd - Added by gstrauss over 3 years ago

In the Configuration section
# lighttpd -t -f /etc/lighttpd/lighttpd.conf
Please prefer -tt, as it performs additional pre-flight checks on the configuration:
# lighttpd -tt -f /etc/lighttpd/lighttpd.conf

You can also point this command to any of the files in your /etc/lighttpd/conf-available/ folder if you want to verify them.

I do not understand what you mean by this.

RE: Debian Wiki page for Lighttpd - Added by CCormier over 3 years ago

The review so far is much appreciated, I've adopted your suggestions into your page. I intend to type up a larger reply soon, but I wanted to quickly address:

I do not understand what you mean by this.

It's reasonable to also check any of the configuration files in /etc/lighttpd/conf-available/, if you've edited them, to ensure they have valid syntax as well. Is that correct? Would there be a more clear way to word this?

RE: Debian Wiki page for Lighttpd - Added by gstrauss over 3 years ago

# lighttpd -t -f /etc/lighttpd/lighttpd.conf will perform a minimal syntax-check to confirm that it is parseable by the parser, but does not validate any of the directives. Yes, you could specify lighttpd -t -f /etc/lighttpd/conf-available/xxxxx.conf

However, if you specified with -tt (e.g. lighttpd -tt -f /etc/lighttpd/conf-available/xxxxx.conf) then lighttpd would fail saying the server.document-root is missing since -tt not only parses the config but also performs validation.
You and I know this, but a beginner might not: changes made to /etc/lighttpd/conf-available/*.conf are not used by lighttpd.conf unless also enabled (lighty-enable-mod).

# lighttpd -tt -f /etc/lighttpd/lighttpd.conf is more thorough than the minimal syntax-check of -t.
-tt is much more useful to the average person trying to find out why lighttpd might not load after changes were made to the configuration.

RE: Debian Wiki page for Lighttpd - Added by CCormier over 3 years ago

Aha, I understand. You're saying that when using the -tt flag, it would be redundant to check any of the specific configuration files for the modules you've enabled, because if they are loaded and enabled, they would already be checked as part of validation. Okay, I'll remove this line from the article.

I apologize for my inexperience in some respects, I'm still fairly new to Lighttpd myself.

RE: Debian Wiki page for Lighttpd - Added by gstrauss over 3 years ago

No need to apologize. I'm thrilled that you bring a fresh perspective and are helping to improve the documentation.

A minimal lighttpd configuration is
server.document-root = "/srv/www"
That's it. (There is some unfortunately necessary complexity with setting up and managing TLS.)

I think that Debian and most other distros make things waaaaaaaay more complicated than needed for beginners.

    (1-8/8)