Setup

This document contains configurations and help for setting up key tools and services that are used by other packages.

GPG Signing

For Github

After creating the gpg-key make sure the follow the directions on github to upload the key on your account. After that is done follow the instructions below.

For Local Machine

Make sure the .gitconfig is configured to have the signingkey ready. To do so you can simply run:

  git config --global user.signingkey <YOUR_KEY_ID>

Trust the key (can skip, however may be necessary).

  gpg --edit-key <YOUR_KEY_ID>

Start the gpg-agent.

  gpgconf --launch gpg-agent

Use pinentry. Depending on your os, there are different versions of pinentry. For example for macos there is pinentry-mac.

For pinentry create a ~/.gnupg/gpg-agent.conf file and add:

  # if not sure of path run `which pinentry` for the case of macos
  # run `which pinentry-mac`

  pinentry-program <PATH_TO_PINENTRY>

Restart the gpg-agent.

  gpgconf --kill gpg-agent
  gpgconf --launch gpg-agent

Make sure the GPG_TTY environment variable is set and then source the configuration.

  export GPG_TTY=$(tty)

Hugo

Probably will not be using Hugo anymore because I will be using Astro moving forward, but in case I ever come back to Hugo here are some configurations and information that may be helpful.

Development

To start a development server run the following command in the root directory of the HUGO files, which is not necessarily the root directory of the project:

    hugo server --minify