initial config and broad api methods