Skip to content

Conversation

@jacksmithxyz
Copy link
Contributor

@jacksmithxyz jacksmithxyz commented Sep 15, 2025

Description

This PR is to convert the Railway deploy guide stub into a full guide for deploying an Astro static site on Railway, as per discussions with @sarah11918.

I've tried to keep inline with your notes and link to specific parts of the Railway docs where relevant, as opposed to saying "click here on the UI" in order to make the guide more applicable and resilient to UI changes.

This first version of the draft PR includes a single version: focusing solely on static site deployment and Railway's web UI.

I think ideally it would be good to expand this guide and/or PR to include project creation with the Railway CLI, deploying from templates, and also provide options for SSR deployment as well as static sites.

Looking forward to any feedback!

Jack

@netlify
Copy link

netlify bot commented Sep 15, 2025

Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 83a5c70
🔍 Latest deploy log https://app.netlify.com/projects/astro-docs-2/deploys/68cc31729b1a1b0008cc2fb3
😎 Deploy Preview https://deploy-preview-12317--astro-docs-2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@astrobot-houston
Copy link
Contributor

astrobot-houston commented Sep 15, 2025

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File Note
en/guides/deploy/railway.mdx Source changed, localizations will be marked as outdated.
Warnings reference
Icon Description
🔄️ The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

@jacksmithxyz jacksmithxyz marked this pull request as ready for review September 16, 2025 15:09
@jacksmithxyz
Copy link
Contributor Author

While writing this guide, Railway have deprecated Nixpacks, and set Railpack as the default builder.

This means Astro websites deployed to Railway with no adapter are automatically deployed as static sites. I have updated this guide in the latest commit to remove the unnecessary railway.json file, as setting Railpack as the default builder is no longer needed.

@sarah11918 sarah11918 added the 3rd-party guide Community submitted CMS, deploy, backend etc. guide label Sep 18, 2025
Copy link
Member

@sarah11918 sarah11918 left a comment

Choose a reason for hiding this comment

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

This looks great, @jacksmithxyz ! I appreciate the clarity and brevity!

I made a commit to just add periods to the end of all the numbered list items (it was easier than multiple suggestions), and I just have one question for you below! Looking forward to getting this updated guide merged really soon! 🙌


[Railway](https://railway.com) is a deployment platform built to simplify your infrastructure stack from servers to observability with a single, scalable platform.

This guide is for deploying an Astro static site to Railway using either the web interface or Railway CLI tool.
Copy link
Member

Choose a reason for hiding this comment

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

Since we say that Railway can also deploy on-demand rendered sites, can we have a sentence here like:

To deploy an on-demand rendered site with a server adapter to Railway...

and then whatever brief guidance we'd give? "... see the Railway SSR deploy guide."

This would just make it seem less strange to come from the main page that has both badges, but see no mention of server rendered apps.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Makes complete sense to me. I'll get this updated.

@sarah11918
Copy link
Member

Just waiting so I can check the deploy preview visually here and make sure it all looks correct, but I think we might have a winner! 😄

Copy link
Member

@sarah11918 sarah11918 left a comment

Choose a reason for hiding this comment

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

Let's do this thing! 🎉

@sarah11918 sarah11918 added the Merge Queue Approved and ready to be merged (wait for feature release if also labelled M-O-R)! label Sep 18, 2025
@sarah11918 sarah11918 merged commit 6efa824 into withastro:main Sep 18, 2025
10 checks passed
@jacksmithxyz jacksmithxyz deleted the railway-deploy-guide branch September 18, 2025 17:15
ArmandPhilippot added a commit to ArmandPhilippot/astro-docs that referenced this pull request Sep 19, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3rd-party guide Community submitted CMS, deploy, backend etc. guide Merge Queue Approved and ready to be merged (wait for feature release if also labelled M-O-R)!

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants