Common problems and solutions

API results only use localhost in the URL, breaking remote razor-client

The URL returned in the /api endpoints is actually generated at runtime based on the hostname you contact. This comes up from the Ruby Rack code, rather than anything we directly control. Generally speaking this tries to resolve your hostname correctly -- and the most common cause of trouble is an entry in /etc/hosts that leads to resolving your server as "localhost" rather than the expected FQDN. Check there first.

spec tests fail on various text related things

Check that your PostgreSQL database was created with the UTF-8 encoding, which we depend on in order to manage text strings correctly. Newer versions default to this, but older versions may default to a locale-specific encoding that will cause failures.