KB: How to setup a custom domain

Technical assistance
5

Well, we got it somehow working:

  1. Enable KB
  2. Modify nginx to use server_name zammad.example.com kb.example.com;
  3. Add wildcard SSL certificates to Zammad nginx config
  4. Modify nginx again :wink: with something quirky like that:
   # "FIX": in order to NOT get redirected to #login route if accessing the kb @ kb.example.com 
   set $fullUrl  "$host$request_uri";

    if ($fullUrl = "kb.example.com/"){
        return 301 https://kb.example.com/help/de-de;
    }

    # Add following lines to "server" directive
    if ($host = kb.example.com ) {
      rewrite ^/(api|assets)/(.*)$ /$1/$2 last;
      rewrite ^/help(.*)$ /help$1 last;
      #rewrite ^(.*)$ /help$1 last;
    }
  1. Set in Zammad KB url as follows:

image
image804×264 21.3 KB

  1. Make the modifications suggest in the KB Zammad backend

Drawbacks

Although it works somehow, there are some issues:

  1. Indication bar (draft, internal, public) will not be displayed
    • I assume this is related to the “catch” with the login route
  2. Opening KB from agents perspective does not work (it think there exists already a github issue)
1 Like