throw meaningful errors if the configuration isnt successful