Mac OS

The following assumes you have Docker Installed
  • Recommended to also have MacOS Homebrew installed
  • Use Homebrew to install jq with brew install jq
In your working directory:
1. Clone a copy of the gaia repo:
$ git clone -b master --single-branch
2. Change your cwd:
$ cd gaia/deploy/docker
3. Create a copy of sample-disk.env and fill out the values:
$ cp sample-disk.env disk.env
# Update the DOMAIN_NAME variable to `localhost`
4. Start the server:
$ docker-compose -f docker-compose-base.yaml -f docker-compose-disk.yaml --env-file disk.env up
5. Verify the server is responding locally:
$ curl -sk https://localhost/hub_info | jq
"challenge_text": "[\"gaiahub\",\"0\",\"gaia-0\",\"blockstack_storage_please_sign\"]",
"latest_auth_version": "v1",
"max_file_upload_size_megabytes": 20,
"read_url_prefix": "https://localhost/reader/"

Modifying the configuration for your gaia-hub

Two methods exist:
  1. 1.
    Edit the gaia/deploy/configs/gaia/hub-config.json using vim or other
  • requires a restart of the containers: docker-compose -f docker-compose-base.yaml -f docker-compose-disk.yaml --env-file disk.env restart
  1. 2.
    Use the running admin container to modify any config values, and also reload the hub when complete:
$ export API_KEY="hello"
$ curl -s \
-H "Authorization: bearer $API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{"serverName": "myserver"}' \
$ curl -s \
-H "Authorization: bearer $API_KEY" \
$ curl -s \
-H "Authorization: bearer $API_KEY" \
http://localhost:8009/v1/admin/config | jq