Deploy Astro-star from Scratch

Step-by-step guide -- even beginners can deploy!

What You Need

• A server
• A registered domain name
• A GitHub account

Environment Preparation

• Node.js >= 22
• pnpm 10.30.x
• PM2

Deployment Process

1. Fork the Repo

Open the project page and fork the repo.

2. Clone the Repo

Clone the forked repo to your local machine.

git clone [fork-repo]
# e.g. git clone https://github.com/hanlife02/Astro-star.git
# Replace hanlife02 with your GitHub username

3. Modify Configuration

For modifying configuration, refer to Configuration Modification.

4. Modify Content

For modifying articles, refer to Creating Content.

5. Set Up Actions Secrets

Open your forked repo on GitHub, and set the following Secrets as shown below.

Required:

Secret	Description
SSH_HOST	Server public IP or domain
SSH_PRIVATE_KEY	SSH private key for deployment

Optional Secrets (add as needed):

Secret	Default	Description
SSH_USER	ubuntu	SSH user
SSH_PORT	22	SSH port
DEPLOY_PATH	~/Astro-star	Directory to deploy on the server
PM2_APP_NAME	Astro-star	PM2 app name
APP_PORT	4321	Node server port
PUBLIC_WALINE_SERVER_URL	empty	Waline server URL written to server .env
ALGOLIA_ADMIN_API_KEY	empty	Algolia admin API key
ALGOLIA_WRITE_API_KEY	empty	Algolia write API key

6. Push Changes

Commit the changes from steps 3 and 4, then push to your GitHub remote repo.

git add .
git commit -m "first deploy"
git push

7. Check Deployment Status

Open the Actions tab to see if the deployment succeeded.

If deployed successfully, your service is now running on port 4321 (or your custom port) on your server.

If you know how, you can check on the server whether the port service is running correctly.

8. Configure Domain Name Resolution

Here we use a domain registered on Alibaba Cloud as an example. Point your registered domain to your server. You can refer to the documentation:

Alibaba Cloud Docs

9. Reverse Proxy Configuration

For reverse proxy configuration, refer to Reverse Proxy Configuration.

Congratulations!

Open your domain with the reverse proxy configured. If your blog homepage displays correctly, congratulations -- you have completed the entire deployment!

If you need to integrate Waline or Algolia, refer to Waline Integration and Algolia Integration.