diff --git a/.env.example b/.env.example
index ddfd4514..a78aa968 100644
--- a/.env.example
+++ b/.env.example
@@ -1,7 +1,7 @@
 # Options: finney (mainnet), test (testnet), local
 SUBTENSOR_NETWORK=finney
 NETUID=74 # 422 if using testnet
-PORT=8099 # neuron axon port 
+PORT=8099 # neuron axon port, must be accessible by public
 
 # Options: info, debug, trace
 LOG_LEVEL=info
@@ -12,11 +12,13 @@ WALLET_NAME=default
 HOTKEY_NAME=default
 
 # For validators: Weights & Biases API key for logging
+# Signup https://wandb.ai/site for a key
 WANDB_API_KEY=
-# Optional custom name for wandb logging 
+# Optional custom name for wandb logging
 WANDB_VALIDATOR_NAME=vali
 
 # For miners: GitHub Personal Access Token
+# https://github.com/settings/personal-access-tokens
 GITTENSOR_MINER_PAT=
 
 # validator database settings (for gittensor validator/dashboard)
diff --git a/README.md b/README.md
index c292831d..d9545cc2 100644
--- a/README.md
+++ b/README.md
@@ -36,6 +36,9 @@ The result: a sustainable incentive layer that channels resources toward buildin
 
 **Recommended: Deploy with Docker**
 
+> [!NOTE]
+> The port in .env must be accessible by the public.
+
 ```bash
 # Quick start
 git clone https://github.com/entrius/gittensor.git