Enabling SSL in Urchin

The below instructions describe how to enabling the Urchin webserver to use SSL. Before beginning, you must acquire a valid SSL Certificate either signed by a certificate authority or self-signed. Visit any of our sponsors below to purchase a signed SSL Certificate.

Enabling SSL on Linux

1. Copy your SSL Certificate into path/to/urchin/var and name it server.crt
2. Copy the SSL Key file into path/to/urchin/var, naming it server.key
3. Open up urchin/var/urchinwebd.conf.template for editing.
   
   1. Urchin versions older than 6.6. ONLY: Comment out the port line and uncomment the Listen line:
      
      #XXXPortXXX
      Listen 443
      
      
   2. Change the ServerName variable from localhost to the name of your webserver (NOTE: Must be the same server name defined in the SSL Certificate).
      
      ServerName: www.mysite.com
      
   
   
4. Restart the Urchin webserver with the SSL option enabled (-e).
   
   Prior to v6.6: urchin/bin/urchinctl -e -w restart
   v6.6+: urchin/bin/urchinctl -e -p 443 -w restart
   
   
   
   
5. Access your Urchin installation at https://servername:port

Enabling SSL on Windows

1. Copy your SSL Certificate into path/to/urchin/var and name it server.crt
2. Copy the SSL Key file into path/to/urchin/var, naming it server.key
3. Open up urchin/var/urchinwebd.conf.template for editing.
   
   1. Urchin versions older than 6.6. ONLY: Comment out the port line and uncomment the Listen line:
      
      #XXXPortXXX
      Listen 443
      
      
   2. Uncomment the following line to load mod_ssl.so when the webserver starts:
      LoadModule ssl_module etc/mod_ssl.so
      
   3. Change the ServerName variable from localhost to the name of your webserver (NOTE: Must be the same server name defined in the SSL Certificate).
      
      ServerName: www.mysite.com
      
   
   
4. Remove and re-install the Urchin webserver with the SSL option enabled (-e).
   
   urchinctl.exe -w remove
   
   Prior to v6.6: urchin/bin/urchinctl.exe -w -e install
   v6.6+: urchin/bin/urchinctl.exe -e -p 443 -w install
   
   
   
   
   
   
5. Access your Urchin installation at https://servername:port