fix: default Compose deployments to the public edge image

[eXPerience83]

What changed

• Change the generic Compose default image from the unpublished stable tag to edge-amd64.
• Change the TrueNAS Compose default image to edge-amd64.
• Align .env.example with the same public experimental image.
• Record the behavior change in CHANGELOG.md.

Why

The repository has no stable release yet. A fresh deployment using the current defaults would try to pull a tag that is not published, while the documented and available testing channel is edge-amd64.

Impact

Fresh generic Docker and TrueNAS deployments now follow the public AMD64 development channel by default. The image remains explicitly experimental and mutable; tested deployments should still record and pin the published digest.

Validation

• make validate
• Build AMD64 and runtime smoke tests pass
• CodeRabbit findings reviewed
• No credentials, host paths or security controls changed
• No stable release is published or promoted

[qodo-code-review]

Qodo reviews are paused for this user.

Troubleshooting steps vary by plan Learn more →

On a Teams plan?
Reviews resume once this user has a paid seat and their Git account is linked in Qodo.
Link Git account →

Using GitHub Enterprise Server, GitLab Self-Managed, or Bitbucket Data Center?
These require an Enterprise plan - Contact us
Contact us →

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: d522ec2b-b572-43dd-93e0-db737c565a7c

📥 Commits

Reviewing files that changed from the base of the PR and between 741a63d and 191d521.

📒 Files selected for processing (4)

• .env.example
• CHANGELOG.md
• compose/docker-compose.yml
• compose/truenas.yml

📜 Recent review details

⏰ Context from checks skipped due to timeout. (1)

• GitHub Check: build

🧰 Additional context used

📓 Path-based instructions (2)

compose/**

⚙️ CodeRabbit configuration file

compose/**: Review Docker Compose files for TrueNAS and generic Docker compatibility.
Flag privileged mode, host networking, Docker socket mounts, overly broad host mounts,
missing authentication, unsafe public bindings and persistence paths that could lose credentials or workspaces.

Files:

• compose/docker-compose.yml
• compose/truenas.yml

**/*.md

⚙️ CodeRabbit configuration file

**/*.md: Check that documentation matches the implemented behavior and clearly distinguishes experimental edge builds
from stable releases. Flag outdated versions, unsafe deployment guidance and claims not proven by CI or testing.

Files:

• CHANGELOG.md

🔇 Additional comments (4)

.env.example (1)

2-2: LGTM!

compose/docker-compose.yml (1)

3-3: LGTM!

compose/truenas.yml (1)

3-3: LGTM!

CHANGELOG.md (1)

30-30: LGTM!

---

Summary by CodeRabbit

• Changed
  • Updated the default Docker image for standard and TrueNAS Compose deployments to the published edge-amd64 image.
  • Clarified in the changelog that edge images are used until the first stable release is available.

Walkthrough

The default Codex container image is changed from the stable tag to edge-amd64 in the example environment and both Compose configurations. The changelog documents this default until the first stable release.

Changes

Edge image defaults

Layer / File(s)	Summary
Update Compose image defaults .env.example, compose/docker-compose.yml, compose/truenas.yml, CHANGELOG.md	Configuration defaults now reference the published edge-amd64 image, retain CODEX_IMAGE overrides, and document the change in the Unreleased changelog.

Estimated code review effort: 1 (Trivial) | ~3 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main change: switching Compose defaults to the public edge image.
Description check	✅ Passed	The description covers what changed, why, impact, validation, and most safety checks, with only minor template sections not separated.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch agent/fix-edge-compose-default

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}