Skip to content

Add quickstart to Hetzner Cloud docs, reorder sections - #699

Merged
tormath1 merged 1 commit into
flatcar:mainfrom
nikodunk:patch-1
Sep 11, 2026
Merged

Add quickstart to Hetzner Cloud docs, reorder sections#699
tormath1 merged 1 commit into
flatcar:mainfrom
nikodunk:patch-1

Conversation

@nikodunk

@nikodunk nikodunk commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Add quickstart to Hetzner Cloud docs, reorder sections

As discussed on Discord, I just found out that you can now install Flatcar on Hetzner with a one-liner if you have Docker installed, as hcloud-image-upload now comes as a Docker image.

This PR does 3 things:

  • Removes old version requirement from 2024.
  • Adds a simplified Quickstart guide at the top to not intimidate newcomers.
  • Restructures the docs around 4 toplevels headings: Quickstart, Creating a server, Creating Snapshots with hcloud-image-upload, Creating Snapshots with Packer. Previously there were 2 toplevels, Creating Snapshots and Creating Servers. No Content Edits were made to these sections, they were just moved

From Discord:

I know we want to cover edge cases in the Hetzner docs, but it looks unnecessarily complicated right now to start with Packer, continue over a many-step process over local binary of hcloud image upload and the Hetzner CLI. Could we add a Quickstart section with this one-liner potentially, and tell you to just select it from the UI after that? Would we be open to me adding a Quickstart section to the above docs?

How to use

Read through https://github.com/nikodunk/flatcar-website/blob/patch-1/content/docs/latest/deploy/cloud/hetzner.md (git hates reordering)

Testing done

I use this flow personally for hobby projects as documented here. Works well if you use the SSH key that Hetzner provides as opposed to Ignition, or you can add custom Ignition files later with the --user-data flag on hcloud's cli.

  • Changelog entries added in the respective changelog/ directory (user-facing change, bug fix, security fix, update)
  • Inspected CI output for image differences: /boot and /usr size, packages, list files for any missing binaries, kernel modules, config files, kernel modules, etc.

@nikodunk
nikodunk requested a review from a team as a code owner September 4, 2026 19:06
Flatcar Container Linux is not installable as one of the default operating system options, but you can deploy it by installing it through the rescue OS.
Flatcar Container Linux is not installable as one of the default operating system options, but you can deploy it by installing it through the rescue OS relatively easily.

These instructions require Flatcar with version `3941.1.0` or newer.

@nikodunk nikodunk Sep 4, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Drive-by: Also removed the minimum version requirement, as 3941 was a non-LTS release from 2024... I doubt anyone will be creating a new server with such an old Flatcar image. Can revert if we want.

@nikodunk nikodunk changed the title Add quickstart to Hetzner Cloud docs Add quickstart to Hetzner Cloud docs, reorder sections Sep 4, 2026
These instructions require Flatcar with version `3941.1.0` or newer.
## Quickstart

## Creating snapshots

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Git hates re-ordering things... please see https://github.com/nikodunk/flatcar-website/blob/patch-1/content/docs/latest/deploy/cloud/hetzner.md for a more sane view.

@nikodunk

nikodunk commented Sep 4, 2026

Copy link
Copy Markdown
Contributor Author

@apricote - @tormath1 noted I should ping you. Thank you for the Docker image of hcloud-image-upload, which simplifies things a lot. I'd like to propose featuring it more prominently at the top as a Quickstart, bc I find it transforms Flatcar-On-Hetzner into a one-liner and use it personally for hobby projects now and I think it makes things a lot less intimidating.

@nikodunk

nikodunk commented Sep 4, 2026

Copy link
Copy Markdown
Contributor Author

As noted on Discord I wasn't as radical as @tormath1 proposed to remove the Packer and Hcloud Image Upload section (XKCD link) and just link to their docs, but instead re-ordered existing content into 4 sections.

Before:

  • Creating Snapshots
  • Creating Servers

After:

  • Quickstart
  • Creating Servers
  • Creating Snapshots with hcloud-upload-image
  • Creating Snapshots with Packer

@tormath1 tormath1 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Thanks - it looks good to me and I like this new order. I let this open a few days to let a chance to @apricote to have a look.

Many thanks for this contribution :)

Signed-off-by: nikodunk <n.dunkel@gmail.com>
@tormath1
tormath1 merged commit be2eca9 into flatcar:main Sep 11, 2026
1 check passed
@tormath1

Copy link
Copy Markdown
Collaborator

I merged this. It can always be revisited later if it does not work as expected. Thanks again for taking the time to contribute.

@nikodunk

nikodunk commented Sep 11, 2026 via email

Copy link
Copy Markdown
Contributor Author

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