Skip to content

docs: clarify image tag descriptions #498

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
MegaRedHand merged 2 commits into from
Jul 6, 2026
Merged

docs: clarify image tag descriptions #498

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b577e3e
docs: clarify image tag descriptions
MegaRedHand Jul 6, 2026
4663527
docs: align devnetX examples with current devnet5
MegaRedHand Jul 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -114,8 +114,8 @@ Docker images are published to `ghcr.io/lambdaclass/ethlambda` with the followin
| Tag | Description |
|-----|-------------|
| `devnetX` | Stable image for a specific devnet (e.g. `devnet4`) |
| `latest` | Alias for the stable image of the currently running devnet |
| `unstable` | Development builds; promoted to `devnetX`/`latest` once tested |
| `latest` | Alias for the latest stable image of the currently running devnet |
| `unstable` | Built from the latest main commit; promoted to `devnetX`/`latest` once tested |
| `sha-XXXXXXX` | Specific commit |

[`RELEASE.md`](./RELEASE.md) has more details on our release process and how to tag new images.
Expand Down
8 changes: 4 additions & 4 deletions RELEASE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,17 +21,17 @@ exact commit it was built from.
On top of that, the workflow accepts a comma-separated list of custom tags as a
parameter (e.g. `latest,devnet2`). We use the following tagging convention:

- `unstable` - the latest image built from the `main` branch, without any devnet-specific features
- `latest` - the latest image built for the current devnet (`devnet3` at the time of writing)
- `devnetX` - the latest image built with `devnetX` support (e.g. `devnet3`, `devnet4`)
- `unstable` - the latest image built from the `main` branch
- `latest` - the latest stable image built for the current devnet (`devnet5` at the time of writing)
- `devnetX` - the latest stable image built with `devnetX` support (e.g. `devnet4`, `devnet5`)

Future devnets will introduce new tags, with previous ones left without updates.

### Pulling an image

```bash
docker pull ghcr.io/lambdaclass/ethlambda:unstable # latest from main
docker pull ghcr.io/lambdaclass/ethlambda:devnet3 # devnet3-compatible
docker pull ghcr.io/lambdaclass/ethlambda:devnet5 # devnet5-compatible
docker pull ghcr.io/lambdaclass/ethlambda:sha-12f8377 # pinned to a specific commit
```

Expand Down
Loading