I use the following config to enable letsencrypt support on all vhosts:

ProxyPass /.well-known/acme-challenge !

Alias /.well-known/acme-challenge/ /var/www/letsencrypt/.well-known/acme-challenge/

<Directory "/var/www/letsencrypt/.well-known/acme-challenge/">
    Options None
    AllowOverride None
    ForceType text/plain
    RedirectMatch 404 "^(?!/\.well-known/acme-challenge/[\w-]{43}$)" 

this works fine for all hosts (mostly php or static sites) except gitlab

I'm using this config: https://github.com/gitlabhq/gitlab-recipes/blob/master/web-server/apache/gitlab-ssl-apache24.conf

My guess is that this config part is a problem:

<Location />
    # New authorization commands for apache 2.4 and up
    # http://httpd.apache.org/docs/2.4/upgrading.html#access
    Require all granted

    #Allow forwarding to gitlab-workhorse
    ProxyPassReverse http://YOUR_SERVER_FQDN/

but what is the best way to solve that?

  • I've been having similar issues with LetsEncrypt and Apache. I'm not sure it is the location block though. I removed the <Location> and even changed the DocumentRoot` to /var/www/html for testing and Gitlab still tries to process any letsencrypt paths, I suspect its actually the rewrite rules for gitlab-workhorse, perhaps adding a NOT condition for the .well-known path might work here. May 17, 2017 at 12:16

1 Answer 1


I think there are two problems here:

  1. The DocumentRoot is something outside of /var/www/letsencrypt
  2. gitlab-workhorse is rewriting the request

The alias stuff should workaround the first problem, but this addition should allow the .well-known request to not get rewritten by GitLab. As per the comment:

#Forward all requests to gitlab-workhorse except existing files like error documents

Gitlab have already written a rule for exclusion, so we can add to it.

Add the following line before the RewriteRule

RewriteCond %{REQUEST_URI} !^.*/\.well-known/.*$ [NC]

This adds a conditional to NOT rewrite requests that contain .well-known. Restart Apache and test.

  • 1
    @kannix No worries. Your question motivated me to resolve the issue for myself as well :) May 17, 2017 at 17:40

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .