From a13c395444b74f13aead320708745b42cca64262 Mon Sep 17 00:00:00 2001
From: Sebastian Nagel <sebastian.nagel@ncoding.at>
Date: Thu, 19 Sep 2024 09:17:19 +0200
Subject: [PATCH 1/2] Update instructions on how to get the explorer
 self-hosted runner up

Something more declarative would be more desirable, but this was an
unplanned effort to get explorer.hydra.family working again.
---
 .github/workflows/README.md | 36 +++++++++++++++++++++++++++++++-----
 1 file changed, 31 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/README.md b/.github/workflows/README.md
index e862589b7dd..c63e734c41b 100644
--- a/.github/workflows/README.md
+++ b/.github/workflows/README.md
@@ -1,17 +1,37 @@
 This explains how to install a cardano runner for the Hydra project.
 
-This runner is used by our smoke-tests and allows us to keep on disk
-an, as up to date as possible, cardano-node database.
+This runner is used by our smoke-tests and allows us to keep on disk an, as up to date as possible, cardano-node database.
 
-# prepare pre-requisites
+# Instance requirements
+
+To host cardano-node instances for `preview`, `preprod` and `mainnet` we need *at least*:
+
+- 150GB of disk space
+- 18GB of RAM 
+
+In AWS an `r5.xlarge` instance type would fit.
+
+# Instance access
+
+Use a shared key to create the instance, connect to it and ensure core
+contributors have access to it using their SSH keys from github. For example:
+
+``` shell
+for GHUSER in ch1bo ffakenz v0d1ch locallycompact noonio; do
+  echo "# ${GHUSER}" >> ~/.ssh/authorized_keys
+  curl https://github.com/${GHUSER}.keys >> ~/.ssh/authorized_keys
+done
+```
+
+# Prepare pre-requisites
 
 Install the following pre-requisites:
 * `git`
 * `docker`
 
-For instance on Debian:
+For instance on Ubuntu:
 ```bash
-sudo apt install git docker
+sudo apt install git docker.io
 ```
 
 Prepare the common directory for cardano database:
@@ -39,6 +59,12 @@ NIX_SSL_CERT_FILE="/etc/ssl/certs/ca-certificates.crt"
 EOF
 ```
 
+Nix should be installed by our actions. However we saw that the github token installed into `/etc/nix/nix.conf` might not be kept up-to-date. Removing it seems to be fine
+
+``` shell
+sudo sed '/access-tokens/d' -i /etc/nix/nix.conf
+```
+
 # Install github runner as a systemd unit
 
 

From 54886eee556473f518200bee9aaeca07b4461797 Mon Sep 17 00:00:00 2001
From: Sebastian Nagel <sebastian.nagel@ncoding.at>
Date: Thu, 19 Sep 2024 09:30:05 +0200
Subject: [PATCH 2/2] Allow explorer workflow to be triggered by hand

---
 .github/workflows/explorer.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/explorer.yaml b/.github/workflows/explorer.yaml
index 5296f5b70d6..cdf76aad3df 100644
--- a/.github/workflows/explorer.yaml
+++ b/.github/workflows/explorer.yaml
@@ -1,5 +1,6 @@
 name: "Explorer"
 on:
+  workflow_dispatch:
   workflow_run:
     workflows: ["Docker"]
     branches: ["master"]