git firewall workaround and docs