Skip to content

docs: Remove stale custom-hosting deployment guides#577

Merged
Zfinix merged 1 commit into
mainfrom
chore/remove-stale-deploy-guides
Jun 4, 2026
Merged

docs: Remove stale custom-hosting deployment guides#577
Zfinix merged 1 commit into
mainfrom
chore/remove-stale-deploy-guides

Conversation

@Zfinix
Copy link
Copy Markdown
Contributor

@Zfinix Zfinix commented Jun 4, 2026

As of Serverpod 3.5+, serverpod create no longer generates the deploy/ folder that the GCE Terraform, GCR Console, and AWS EC2 Terraform guides depend on (see serverpod/serverpod#4703). Following these guides today leaves users without the script files they reference.

Removed:

  • 02-google-cloud-engine-terraform.md
  • 03-google-cloud-run-console.md
  • 04-aws-ec2-terraform.md

Also:

  • Renumbered 05-hosting-elsewhere.md to 02- and 06-community-supported.md to 03- to close the gap.
  • Updated 01-choosing-a-strategy.md: dropped the three deleted bullets from the "Pick a guide" list and the now-inaccurate "the following pages walk through each path" clause.
  • Added description frontmatter to the two surviving pages.
  • Trimmed a noise-pattern preamble sentence on 02-hosting-elsewhere.md.

No external pages linked to the deleted slugs. The only inbound reference (01-choosing-a-strategy.md's "Pick a guide" list) was updated in this PR.

Closes #564

Related: serverpod/serverpod#4703

@Zfinix Zfinix force-pushed the chore/remove-stale-deploy-guides branch from d03f1b2 to 0c4b073 Compare June 4, 2026 07:02
@Zfinix Zfinix requested review from Swiftaxe and developerjamiu and removed request for Swiftaxe June 4, 2026 07:18
@Zfinix Zfinix self-assigned this Jun 4, 2026
Copy link
Copy Markdown
Contributor

@developerjamiu developerjamiu left a comment

Choose a reason for hiding this comment

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

LGTM.

This looks like losing some valuable information to the community though there's not much we can do about it. I think one thing we can do is have a todo to repurpose some of these pages to hold a list of well tested articles written by community members on how to deploy to other platforms.

@Zfinix
Copy link
Copy Markdown
Contributor Author

Zfinix commented Jun 4, 2026

LGTM.

This looks like losing some valuable information to the community though there's not much we can do about it. I think one thing we can do is have a todo to repurpose some of these pages to hold a list of well tested articles written by community members on how to deploy to other platforms.

Yes it is some valuable information lost, and yes i think we need deployment docs to AWS, GCP, Railway etc, it would make development a breeze, but the docs in its current state is fundamentally broken as the /deploy folder and all its files don't ship with new projectes anymore so Im not sure, maybe we can create an issue for this @Swiftaxe.

Copy link
Copy Markdown
Collaborator

@Swiftaxe Swiftaxe left a comment

Choose a reason for hiding this comment

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

These guides still exist under older versions, so the information is not completely lost. They are outdated, though, and should not ship with the latest docs.

I will create an issue to address this with a better solution.

@Zfinix Zfinix merged commit 4ef13a8 into main Jun 4, 2026
5 checks passed
@Zfinix Zfinix deleted the chore/remove-stale-deploy-guides branch June 4, 2026 11:48
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.

Remove reference to old scripts in deployment pages

3 participants