Getting started with Astro apps, the easy way
You can start an Astro project in several ways, by using the official CLI, grabbing a community starter from GitHub, or wiring up your own config, but if you’re looking for the fastest and smoothest way, Diploi makes it ridiculously easy.
What you need
- A GitHub account, sign up here if you don’t have one yet: https://github.com/signup
How to create an app with Astro
- Sign up for a free Diploi account at https://console.diploi.com/
- In the Dashboard, click Create Project +
- Under Pick Components, choose Astro You can also add additional tools or services here if you want to extend your stack.
- In Pick Add-ons, select any databases or extra tools you need.
- Choose Create Repository so Diploi generates a brand new GitHub repo for your project.
- Click Launch Stack
Diploi will spin up a full Development environment in the cloud where you can:
- Preview your Astro site live instantly
- Code directly in the browser using the built-in IDE
- Or connect remotely via SSH using VS Code, Cursor, or any dev container–friendly IDE
Launching your Astro app to Production
When you’re ready to go live:
- Open your Astro Project’s dashboard:
https://console.diploi.com/<YOUR_USERNAME>/project/<YOUR_PROJECT_ID>
- Click Create Deployment +
- Select Production as the deployment stage
- Choose the cluster size depending on your needs
- Pick the source branch you want to deploy, such as
main
- Customize any necessary environment variables
- Click Create Deployment +
Your Astro site is now fully deployed and ready to scale!
Configuring a custom domain for your Astro site in Production
By default, your site will use a .diploi.app
URL. To switch to a custom domain:
- Head to your Production Deployment’s Options tab, or go directly to:
https://console.diploi.com/<YOUR_USERNAME>/project/<YOUR_PROJECT_ID>/deployment/<YOUR_DEPLOYMENT_ID>/options
- In the Endpoints section, click to disable Use Auto‑Generated Endpoints
- A field will appear showing your current Diploi subdomain, and a checkbox to enable a custom domain
- Enable the checkbox and enter your custom domain name
- Scroll down and click Save Changes
- In your DNS settings, create a CNAME record pointing to edge.diploi.com
Give it up to 30 minutes for DNS and SSL propagation to complete.
Trying out Astro for the first time?
You don’t need to install anything, just try Astro in the cloud on Diploi in two simple ways:
-
Not signed up yet? Head to https://diploi.com/#StackBuilder to launch a trial project, or go straight to the Astro component page: https://diploi.com/component/astro
-
Already have a Diploi account? Create a new project and in the Repository section, select Quick Launch. This gives you a temporary environment to explore Astro without connecting a repo.
Want to see other frameworks supported on Diploi? Let us know on Discord!
Sign up at Diploi and get 50 € in free credits.
References: