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 https://github.com/stacks-network/gaia
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/"
}
Two methods exist:
- Edit the
gaia/deploy/configs/gaia/hub-config.json
usingvim
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
- 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' \
-X POST \
--data-raw '{"serverName": "myserver"}' \
http://localhost:8009/v1/admin/config
$ curl -s \
-H "Authorization: bearer $API_KEY" \
-X POST \
http://localhost:8009/v1/admin/reload
$ curl -s \
-H "Authorization: bearer $API_KEY" \
http://localhost:8009/v1/admin/config | jq