Skip to content

Add SEV getting started guide for users - #171

Merged
DGonzalezVillal merged 1 commit into
AMDEPYC:mainfrom
LakshmiSaiHarika:getting-started-user-guide
Sep 2, 2026
Merged

Add SEV getting started guide for users#171
DGonzalezVillal merged 1 commit into
AMDEPYC:mainfrom
LakshmiSaiHarika:getting-started-user-guide

Conversation

@LakshmiSaiHarika

Copy link
Copy Markdown
Contributor

Created an easy-to-use Getting Started SEV guides for different users:

  • Host
  • Guest
  • Verifier

@DGonzalezVillal DGonzalezVillal left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the guide could use a bit more clarity around its main intention.

From my perspective, the goal of this guide should be to quickly introduce SEV and provide concise setup instructions for SNP. I emphasize SNP because that’s the feature we want users to focus on adopting, so it’s probably not necessary to go too deep into SEV-specific details.

I added some suggestions to help improve the organization of the guide and narrow its scope a bit. I think it’s meant for users who want to start using SNP but may not know how to get started.

One additional note — for users who simply want to use SNP (not certify an OS), we probably shouldn’t direct them to use the artifacts from this repository. Instead, they should check which operating systems we’ve already certified and then download the official releases for their hosts or guests. The images in this repo are minimized and slightly modified versions of the official ones, so they’re not intended for real production environments.

Comment thread docs/getting-started-user-guide-for-sev.md Outdated
Comment thread docs/getting-started-user-guide-for-sev.md Outdated
Comment thread docs/getting-started-user-guide-for-sev.md Outdated
Comment thread docs/getting-started-user-guide-for-sev.md Outdated
Comment thread docs/getting-started-user-guide-for-sev.md Outdated
Comment thread docs/getting-started-user-guide-for-sev.md Outdated
Comment thread docs/getting-started-user-guide-for-sev.md Outdated
Comment thread docs/getting-started-user-guide-for-sev.md Outdated
Comment thread docs/getting-started-user-guide-for-sev.md Outdated
Comment thread docs/getting-started-user-guide-for-sev.md Outdated

@DGonzalezVillal DGonzalezVillal left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a couple of more things, mostly wordking. the rest of it looks good thanks !

Comment thread docs/getting-started-user-guide-for-sev.md Outdated
Comment thread docs/getting-started-user-guide-for-sev.md Outdated
Comment thread docs/getting-started-user-guide-for-sev.md Outdated
Comment thread docs/getting-started-user-guide-for-sev.md Outdated
@LakshmiSaiHarika
LakshmiSaiHarika force-pushed the getting-started-user-guide branch 2 times, most recently from 68b7aaf to eda5080 Compare September 1, 2026 17:01

@DGonzalezVillal DGonzalezVillal left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey Harika it looks great.

Just one comment. The guest policy is incomplete, just fix that and then we can merge! Thank you!

Comment on lines +114 to +123
The 64-bit policy value controls security requirements for the SNP guest:

| Bit(s) | Name | Meaning when set |
|--------|------|------------------|
| 0 | `SMT` | Guest may be launched on a host with SMT enabled |
| 1 | `RESERVED` | Must be 1 |
| 2 | `MIGRATE_MA` | Guest may be associated with a migration agent |
| 3 | `DEBUG` | Debugging of the guest is allowed (disables production security) |
| 16-17 | `ABI_MAJOR` | Minimum ABI major version required |
| 18-25 | `ABI_MINOR` | Minimum ABI minor version required |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Incomplete please see guest policy in: https://docs.amd.com/v/u/en-US/56860_PUB_SEV_SNP

@LakshmiSaiHarika
LakshmiSaiHarika force-pushed the getting-started-user-guide branch from eda5080 to ce29cc0 Compare September 1, 2026 23:17
Signed-off-by: Harika Nittala <lnittala@amd.com>

@DGonzalezVillal DGonzalezVillal left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM thank you Harika!

@DGonzalezVillal
DGonzalezVillal merged commit 86e8a96 into AMDEPYC:main Sep 2, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants