diff --git a/README.md b/README.md
index 4003658..9725f01 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,6 @@
# Codex Testnet Starter
Hit the ground running with Codex.
-1. [Overview](#overview)
-2. [How to start](#how-to-start)
-3. [How to get ready](#how-to-get-ready)
-4. [How to use](#how-to-use)
-5. [How to stop](#how-to-stop)
-6. [How to stop and delete everything](#how-to-stop-and-delete-everything)
-7. [Troubleshooting](#troubleshooting)
-
-
-## [Overview](#codex-testnet-starter)
-
-Using the Testnet Starter, you can run a (mostly preconfigured) Codex node on your machine. You always have the option to build and run Codex from sources [Here](https://github.com/codex-storage/nim-codex/).
-
### Links
- Codex Website - [codex.storage](https://codex.storage)
- Codex Whitepaper - [codex.storage](https://codex.storage)
@@ -22,183 +9,3 @@ Using the Testnet Starter, you can run a (mostly preconfigured) Codex node on yo
- Block explorer - [explorer.testnet.codex.storage](https://explorer.testnet.codex.storage)
- Web wallet - [wallet.testnet.codex.storage](https://wallet.testnet.codex.storage)
-
-## [How to start](#codex-testnet-starter)
- 1. [Have Docker with compose installed](https://docs.docker.com/engine/install/)
-
- 2. Clone this repo
- ```shell
- git clone https://github.com/codex-storage/codex-testnet-starter && cd codex-testnet-starter
- ```
-
- 3. Create an Ethereum public/private key pair using [web wallet](https://wallet.testnet.codex.storage) or consider other local methods
-
- Use Docker
-
- ```shell
- # Generate keypair
- docker run --rm gochain/web3 account create
- ```
-
-
-
- Use MetaMask
-
- 1. [Accounts and Addresses](https://support.metamask.io/hc/en-us/sections/4471975962907-Accounts-and-Addresses)
- 2. [How to export an account's private key](https://support.metamask.io/hc/en-us/articles/360015289632-How-to-export-an-account-s-private-key)
-
-
-
- Use Python code
-
- 1. Create a venv
- ```shell
- pip3 install virtualenv
-
- venv=codex-eth-key
- mkdir $venv && cd $venv
-
- python3 -m venv env
- source env/bin/activate
- ```
-
- 2. Install required packages
- ```shell
- pip3 install web3
- ```
-
- 3. Create a script
- ```shell
- vi eth-keys.py
- ```
- ```python
- from eth_account import Account
-
- def generate_ethereum_keypair():
- # Generate a new Ethereum account
- account = Account.create()
-
- # Get the private key
- private_key = account._private_key.hex()
-
- # Get the public key (Ethereum address)
- public_key = account.address
-
- return private_key, public_key
-
- # Generate the Ethereum key pair
- private_key, public_key = generate_ethereum_keypair()
-
- # Print the keys
- print("Private Key:", private_key)
- print("Public Key (Ethereum Address):", public_key)
- ```
-
- 4. Generate the keys
- ```shell
- python3 eth-keys.py
- ```
- 5. Cleanup
- ```shell
- deactivate
- cd .. && rm -rf $venv
- ```
-
-
- ```
- # Example
- Private key: 0xacec4df7549199708a9f66b151aea7bf41b4d30bd325b96b26f017246226e1a3
- Public address: 0x1C408C8572ce7d5E79a3a6D353e5FC2E8E2c49ce
- ```
-
- 4. Define variables
- ```shell
- export PRIV_KEY=0xacec4df7549199708a9f66b151aea7bf41b4d30bd325b96b26f017246226e1a3
- export CODEX_LISTEN_ADDRS=/ip4/0.0.0.0/tcp/8070
- export CODEX_DISC_PORT=8090
-
- # export CODEX_ETH_PROVIDER=https://rpc.testnet.codex.storage
- # export CODEX_LOG_LEVEL=TRACE
- #
- # export GETH_DISCOVERY_PORT=8547
- # export GETH_PORT=8548
- # export GETH_NAT=extip:1.1.1.1
- # export GETH_VERBOSITY=3
- ```
-
- 5. Run local nodes
- ```shell
- docker-compose up -d
- ```
-
- 6. Setup port forwarding on your router for Codex, based on defined values
- ```
- TCP - CODEX_LISTEN_ADDRS=/ip4/0.0.0.0/tcp/8070
- UDP - CODEX_DISC_PORT=8090
- ```
-
-
-## [How to get ready](#codex-testnet-starter)
-When starting the Testnet Starter for the first time, (or restarting after a long pause) please keep in mind:
-- Your local Geth node will need time to sync.
-- Geth checker will wait until Geth is in sync and only then Codex will start.
-
-Before you can use the marketplace functionality of Codex, you will need to obtain some tokens in the Testnet.
-1. Use web faucets
- - ETH - [faucet-eth.testnet.codex.storage](https://faucet-eth.testnet.codex.storage)
- - TST - [faucet-tst.testnet.codex.storage](https://faucet-tst.testnet.codex.storage/)
-
-2. Or join the [Codex Discord server](https://discord.gg/codex-storage)
-
- Get tokens on Discord server faucet
-
- 1. Find the `#bot` channel.
- 2. Give your public key to the bot using `set` command.
-
- example
-
- 
-
- 3. Ask it politely to mint some tokens for you using `mint` command.
-
- example
-
- 
-
- (It may or may not happen in the future that testnet participation will be rewarded automatically with Discord server roles.)
-
-
-
-## [How to use](#codex-testnet-starter)
-Once running, Codex exposes a web-api at the API port. (default: 8080)
-To read more about how to use the API, go [Here](/USINGCODEX.md)
-
-
-## [How to stop](#codex-testnet-starter)
-- `docker-compose down`
-
-
-## [How to stop and delete everything](#codex-testnet-starter)
-- `docker-compose down --rmi all -v`
-
-
-## [Troubleshooting](#codex-testnet-starter)
-
-
-### Geth
-```shell
-# List peers
-docker exec -it geth geth attach --exec net.peerCount /data/geth.ipc
-
-# Connected peers
-docker exec -it geth geth attach --exec admin.peers /data/geth.ipc
-
-# Add a peer
-docker exec -it geth geth attach --exec 'admin.addPeer("enode://cff0c44c62ecd6e00d72131f336bb4e4968f2c1c1abeca7d4be2d35f818608b6d8688b6b65a18f1d57796eaca32fd9d08f15908a88afe18c1748997235ea6fe7@159.223.243.50:40010")' /data/geth.ipc
-
-# Sync status
-docker exec -it geth geth attach --exec eth.syncing /data/geth.ipc
-
-# Geth own enode
-docker exec -it geth geth attach --exec admin.nodeInfo.enode /data/geth.ipc
-```
diff --git a/WORKSHOPSETUP.mb b/WORKSHOPSETUP.mb
new file mode 100644
index 0000000..23cd52c
--- /dev/null
+++ b/WORKSHOPSETUP.mb
@@ -0,0 +1,51 @@
+# Workshop Setup
+With these instructions you can set up a Codex node on your machine, to use during the Brussels 2024 workshop. If you run into trouble and need help, ask a nearby Codexer!
+
+## Local network
+Switch to the workshop wifi:
+- SSID: `codex`
+- Password: `ethcc2024`
+
+## Clone this repository
+```
+git clone https://github.com/codex-storage/codex-testnet-starter.git
+```
+
+Open a terminal in the scripts folder for your platform:
+- `scripts/linux`
+- `scripts/mac`
+- `scripts/windows`
+
+## Download Codex
+Run `download` script.
+
+## Generate an Eth key-pair
+Run `generate` script.
+
+Keep your public key at hand. Update the file named `eth.key` with your private key. You may need to change the permissions for this file. See the README.md in your platform specific folder.
+
+## Start Codex node
+Determine your local IP address. Use `ifconfig` or `ipconfig`, depending on your platform.
+
+Set local IP environment variable
+ - Bash: `export LOCALIP="192.168.179.999"`
+ - Batch: `set LOCALIP="192.168.179.999"`
+
+Run `run_client` script.
+
+## Acquire tokens
+You can acquire tokens in one of two ways: Discord bot or faucet.
+
+### Discord bot
+ - Join the Codex discord server: https://discord.gg/codex-storage.
+ - Go to the "bot" channel, in the category "codex-bot".
+ - Use `/set` command to enter your public key.
+ - Use `/mint` command to receive some tokens.
+
+### Faucet
+ - Follow instructions on https://faucet-eth.testnet.codex.storage to get some Eth.
+ - Follow instructions on https://faucet-tst.testnet.codex.storage to get some test tokens.
+You will need both Eth and test tokens to use Codex.
+
+## Use Codex
+You can now proceed to use your Codex node. Follow the instructions [here](./USINGCODEX.md)
diff --git a/scripts/linux/README.md b/scripts/linux/README.md
index 642676a..9a2dd75 100644
--- a/scripts/linux/README.md
+++ b/scripts/linux/README.md
@@ -1,3 +1,6 @@
-# May need
-`sudo apt-get install libzip-dev unzip`
+# Permissions
+To fix the permissions of your eth.key file:
`chmod 600 eth.key`
+
+# Additional requirements for prover
+`sudo apt-get install libzip-dev unzip`
diff --git a/scripts/windows/README.md b/scripts/windows/README.md
index 3e81739..2a208c9 100644
--- a/scripts/windows/README.md
+++ b/scripts/windows/README.md
@@ -1,11 +1,14 @@
-# May need
-Right-click 'eth.key' file -> Properties
--> Security -> Advanced
-Add -> Select a principal -> Advanced -> Find now
-Select you user from the list
-OK -> OK
-Check Full control, Modify, Read&exe, Read, Write, Special
-OK
-Disable inheritance -> Confirm warning
-Apply and close
-Apply and close
+# Permissions
+To fix the permissions of your eth.key file in Windows:
+ - Right-click 'eth.key' file
+ - Properties
+ - Security
+ - Advanced
+ - Add -> Select a principal -> Advanced -> Find now
+ - Select you user from the list
+ - OK -> OK
+ - Check: "Full control", "Modify", "Read&exe", "Read", "Write"
+ - OK
+ - Disable inheritance -> Confirm warning
+ - Apply and close
+ - Apply and close