Navigate to: Github - New Application and enter similar values to:
- Enter Application Name:
MyGitcoinApp
- Homepage URL:
http://localhost
- Application description:
My Gitcoin App
- Authorization callback URL:
http://localhost:8000/
(required)
The authorization callback URL should match your BASE_URL
value in web/app/app/.env
Update the web/app/app/.env
file to include the values provided by Github:
GITHUB_CLIENT_ID=xxxx
GITHUB_CLIENT_SECRET=xxx
GITHUB_APP_NAME=MyGitcoinApp
Please docker-compose down; docker-compose up -d
to have the environment variable changes reflect in your local Gitcoin environment.
Navigate to: Github - New Token
At minimum, select user
scope.
Update the web/app/app/.env
file to include the values provided by Github:
GITHUB_API_TOKEN=xxx
GITHUB_API_USER=xxx
Make sure you disable gitcoinbot notifications on your local, unless you are specifically testing that feature
By default, we disable outbound GitHub notifications to any repository that isn't under the GITHUB_API_USER
repositories.
For example, if settings.GITHUB_API_USER == gitcoinco
only github.com/gitcoinco/<repos>
bounties and associated tips will post Github comments.
# Be VERY CAREFUL when changing this setting. You don't want to accidently
# send a bunch of github notifications :)
ENABLE_NOTIFICATIONS_ON_NETWORK=None
Navigate to: Gitcoinbot Github App
Copy the application ID found on the page as the GITCOINBOT_APP_ID
environment variable.
Make sure you disable gitcoinbot notifications on your local, unless you are specifically testing that feature
# Be VERY CAREFUL when changing this setting. You don't want to accidentally
# send a bunch of github notifications :)
ENABLE_NOTIFICATIONS_ON_NETWORK=None
The following environment variables must be set for gitcoinbot to work correctly:
GITHUB_API_USER=gitcoinbot # Github Profile name of the bot. Defaults to: gitcoinbot
GITCOINBOT_APP_ID=APP_ID_FROM_ABOVE # Defaults to empty.
GITCOIN_BOT_CERT_PATH=RELATIVE_PATH_TO_CERT_FILE # Defaults to empty.
GITHUB_API_USER=gitcoinbot # Github Profile name of the bot. Defaults to: gitcoinbot
GITCOINBOT_APP_ID=7735 # Gitcoin Bot App ID
GITCOIN_BOT_CERT_PATH=app/gitcoin_bot_secret.pem # If pem file is located at web/app/app/gitcoin_bot_secret.pem
Aside from these environment variables, the settings page of the gitcoin bot application must have the correct url for webhook events to post to. It should be set to https://gitcoin.co/payload
based on urls.py line 131.
After running the migrations and deploying the gitcoin.co website, gitcoinbot will begin to receive webhook events from any repository that it is installed into. This application will then parse through the comments and respond if it is called with @gitcoinbot + registered action call.
Error tracking is entirely optional and primarily for internal staging and production tracking. If you would like to track errors of your local environment, setup an account at: Sentry.io
Once you have access to your project secrets, you can enable Sentry error tracking for both the backend and frontend by adding the following environment variables to web/app/app/.env
:
SENTRY_USER=xxx
SENTRY_PASSWORD=xxx
SENTRY_ADDRESS=https://sentry.example.xxx
SENTRY_PROJECT=2