Skip to content

Instantly share code, notes, and snippets.

@crcdng
Last active June 11, 2023 22:00
Show Gist options
  • Save crcdng/5813222dab9d300681b79536aad41265 to your computer and use it in GitHub Desktop.
Save crcdng/5813222dab9d300681b79536aad41265 to your computer and use it in GitHub Desktop.
Mini Tutorial - run hydra locally (tested on Mac Ventura / Chrome 113)

prerequisites: git, node.js, yarn, chrome browser as decribed here: https://github.com/hydra-synth/hydra#running-locally. run the commands below in Terminal

note: the parameters reduce the size of the download a bit

git clone --depth 1 --branch "main" https://github.com/hydra-synth/hydra.git

cd hydra

note: the --ignore-engines parameter is necessary because at the time of this writing the dependencies of hydra won't allow node.js > 16

yarn install --ignore-engines

note: by now (chrome version 113) chrome does not open local webapps without some kind of ssl certificate. the next steps create a self-signed certificate. chrome will then complain but let us open the app.

cd backend/certs

in the backend/certs directory create a file called 'req.cnf' (adapted from https://stackoverflow.com/questions/21397809/create-a-trusted-self-signed-ssl-cert-for-localhost-for-use-with-express-node)

[req]
distinguished_name = req_distinguished_name
x509_extensions = v3_req
prompt = no
[req_distinguished_name]
C = DE
ST = Berlin
L = Berlin
O = doesntmatter
OU = doesntmatter 
CN = www.localhost.com
[v3_req]
keyUsage = critical, digitalSignature, keyAgreement
extendedKeyUsage = serverAuth
subjectAltName = @alt_names
[alt_names]
DNS.1 = www.localhost.com
DNS.2 = localhost.com
DNS.3 = localhost

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout key.pem -out certificate.pem -config req.cnf -sha256

cd ../..

yarn serve

open https://localhost:8000 in chrome -> 'Advanced' 'Proceed' (the first time)

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