Skip to content

Commit 775649e

Browse files
committed
feat: update submission workflow to include Docker Hub credentials configuration and security guidelines
1 parent 440133b commit 775649e

1 file changed

Lines changed: 31 additions & 1 deletion

File tree

docs/miner/workflow/4.submit-commit.md

Lines changed: 31 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,37 @@ For example:
6565
- Only one commit per challenge is allowed in the `active_commit.yaml` file. If you add multiple commits for the same challenge, only the last one will be considered during submission and others will be ignored.
6666
- We are allowing only one commit per challenge/day for submission to avoid spam, abuse, unnecessary network load, and fair evaluation for all participants.
6767

68-
## 4.3. Configure environment variables
68+
## 4.3. Configure Docker Hub credentials
69+
70+
Your miner needs Docker Hub credentials to pull your private images during validation. See the [Docker Hub Registry & PAT guide](../concepts/dockerhubpat.md) for full details — here is a summary of what to prepare:
71+
72+
!!! warning "One Username Policy"
73+
All images in your `active_commit.yaml` must use a **single Docker Hub username**. Mixing usernames (e.g. `alice/solver` and `bob/detector`) will cause authentication failures because only one set of credentials is used for pulling.
74+
75+
**Before continuing, make sure you have:**
76+
77+
1. **A private Docker Hub repository** — public repos expose your solution to competitors. Go to your repo **Settings → Visibility → Private**.
78+
2. **A Personal Access Token (PAT)** with **Read-only** scope — never use your account password. Generate one at [hub.docker.com/settings/security](https://hub.docker.com/settings/security).
79+
3. **Verified the token works** locally:
80+
81+
```bash
82+
echo "<your-pat>" | docker login -u <your-username> --password-stdin
83+
# Expected output: Login Succeeded
84+
```
85+
86+
These values go into your `.env` file in the next step:
87+
88+
| `.env` variable | Value |
89+
|---|---|
90+
| `DOCKER_HUB_USERNAME` | Your Docker Hub username |
91+
| `DOCKER_HUB_PAT` | The Read-only PAT you generated |
92+
93+
!!! danger "Never commit your PAT"
94+
Add `.env` to your `.gitignore`. If you accidentally expose a PAT, revoke it immediately from the [security settings page](https://hub.docker.com/settings/security) and generate a new one.
95+
96+
---
97+
98+
## 4.4. Configure environment variables
6999

70100
- You need [Bittensor wallet that registered](../../manuals/bittensor/wallet/register.md) on RedTeam Subnet 61.
71101

0 commit comments

Comments
 (0)