New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Self hosting instructions #42

AberSheeran opened this Issue Jun 21, 2018 · 2 comments


None yet
2 participants

AberSheeran commented Jun 21, 2018

Hello, I have a question to ask. Your server is blocked in my area, how can I copy your program to my own server?

@jdanyow jdanyow added the question label Jun 24, 2018


This comment has been minimized.


jdanyow commented Jun 24, 2018

There are two components- the utterances API (a node app) and the web site (static html/css/js site). I run the API on Azure and the web site on github pages.

To setup the API:

  1. Create a new Azure Web App:
    The free tier will work. A paid tier will work better.
    OS doesn't matter- windows or linux.
    Under "deployment options", choose "local git".
    Go back to the "general" tab and make note of the "git clone url" (eg https://[username]@[app name][app name].git) and the "url" (eg https://[app name]

  2. Create a new github app:
    Here are the fields that matter:

    field value
    GitHub App name your blog's name
    Description your blog's description
    Homepage URL your blog's url
    User authorization callback URL the url of your azure web app, with /authorized appended. For example,
    Webhook URL It's a required field, but utterances doesn't use it. Pick anything... your blogs url... doesn't matter.
    Permissions Issues: Read & Write. No other permissions necessary.
    Where can this GitHub App be installed Only on this account

    Once you've created your app you'll be prompted to generate a private key. This is a required step. Utterances doesn't use the key so don't worry about remembering the value.
    Make note of your github apps Client ID and Client Secret... you'll need those values later...

  3. Go back to your azure web app and navigate to the "application settings" tab, then scroll to the "application settings" area and add the following settings:

    setting value
    BOT_TOKEN a personal access token with public_repo scope that will be used when creating GitHub issues: generate here.
    CLIENT_ID The client id to be used in the GitHub OAuth web application flow. Copy from your GitHub App's page.
    CLIENT_SECRET The client secret for the OAuth web application flow. Copy from your GitHub App's page.
    STATE_PASSWORD 32 character password for encrypting state in request headers/cookies. Generate here.
    ORIGINS comma delimited list of permitted origins. For CORS. Enter https://[your github account],http://localhost:4000)
    APP_ROOT Your azure web app's url (eg
    USER_AGENT The GitHub API requires a User-Agent header. Put anything here... "my awesome blog"... whatever.
  4. Deploy the app...

    git clone
    cd utterances-oauth
    git remote add azure [the azure web app's git clone url from step 1]
    git push azure
  5. Verify the app is running by going to https://[app name] you should see blank page with the text "alive".

To setup the web site:

  1. Install yarn
  2. Fork this repo:
  3. Clone your fork: git clone[your-acount]/utterances
  4. Remove the && echo '' > dist/CNAME from this line:
    "predeploy": "yarn run build && touch dist/.nojekyll && echo '' > dist/CNAME",

    (this tells github pages what my custom domain name is... you won't need this)
  5. Change this url to the url of your azure web app:
    export const UTTERANCES_API = '';
  6. Update some of the attributes here:
    <if condition="NODE_ENV === 'production'">
    <script src=""
    <script src="http://localhost:4000/client.js"

    Change src="" to https://[your github account]
    Change repo="..." to whatever repo you're storing your blog comments in.
  7. Execute yarn start, then go to http://localhost:4000/index.html and verify you're able to sign-in, post comments, etc.
  8. Execute yarn run deploy to deploy to github pages. Then go to https://[your github account] verify you can sign-in, post comments, etc.

Let me know if you have any questions 🔮


This comment has been minimized.

AberSheeran commented Jun 25, 2018

Thank your help. 😄 I will do it.

@jdanyow jdanyow changed the title from How can I copy your program to my own server? to Self hosting instructions Jun 30, 2018

@jdanyow jdanyow closed this Jun 30, 2018

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment