OS X Server: Allowing custom URL protocols in links via wiki service

Learn how to enable custom URL protocols for the Lion Server Wiki service (so they become clickable links on a wiki page).

This article has been archived and is no longer updated by Apple.

By default, links in a wiki page that use common URL protocols such as http, ftp, and so forth are already clickable.

If you wish to create links containing a custom protocol, such as irc or scp, follow the directions below.

  1. Create whitelist_file per the version of OS X Server you're using.
    On Lion Server, whitelist_file refers to /etc/collabd/filter_whitelist.plist.
    On OS X Server (Mountain Lion), whitelist_file refers to /Library/Server/Wiki/Config/whitelist.plist.
  2. Use the guidelines in How to edit configuration files to add this content to the file:
  3. <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
  4. Verify that the file's syntax is correct. An easy way to do so is by using the plutil(1) command:
  5. plutil whitelist_file
  6. Ensure that the permissions on the file are such that it will be accessible to the wiki service:
  7. sudo chown _teamsserver:_teamsserver whitelist_file
    sudo chmod 644 whitelist_file


Information about products not manufactured by Apple, or independent websites not controlled or tested by Apple, is provided without recommendation or endorsement. Apple assumes no responsibility with regard to the selection, performance, or use of third-party websites or products. Apple makes no representations regarding third-party website accuracy or reliability. Risks are inherent in the use of the Internet. Contact the vendor for additional information. Other company and product names may be trademarks of their respective owners.

Published Date: