Skip to content

Commit 9fe4558

Browse files
author
Yuanlin Lin
authored
Add Zeabur deployment guide (#2408)
* Add Zeabur deployment guide * Select Zola version in Zeabur deployment
1 parent 52b29df commit 9fe4558

File tree

1 file changed

+66
-0
lines changed
  • docs/content/documentation/deployment

1 file changed

+66
-0
lines changed
Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
+++
2+
title = "Zeabur"
3+
weight = 50
4+
+++
5+
6+
In this tutorial, we'll guide you through the process of deploying your Zola site onto the [Zeabur](https://zeabur.com). Zeabur provides a seamless deployment experience, with automatic SSL certificates and global-edge network delivery. Let's get started!
7+
8+
## Prerequisites
9+
10+
- A Zola site project on your local machine.
11+
- A GitHub account and your Zola site project repository hosted on GitHub.
12+
- A Zeabur account. If you don't have one, sign up at [here](https://zeabur.com/login).
13+
14+
## Step 1: Create a Project on Zeabur
15+
16+
1. Log in to your Zeabur account.
17+
2. Navigate to the dashboard and click on the **Create Project** button.
18+
3. Follow the on-screen instructions to set up a new project.
19+
20+
## Step 2: Push Your Zola Files to GitHub
21+
22+
1. Initialize a Git repository in your Zola project folder if you haven't already:
23+
24+
```bash
25+
git init
26+
git add .
27+
git commit -m "Initial commit"
28+
```
29+
30+
2. Push your Zola project to GitHub:
31+
32+
```bash
33+
git remote add origin <your-github-repo-url>
34+
git branch -M main
35+
git push -u origin main
36+
```
37+
38+
Replace `<your-github-repo-url>` with the URL of your GitHub repository.
39+
40+
## Step 3: Create a Service on Zeabur
41+
42+
1. Back in your Zeabur dashboard, click on **Create Service**.
43+
2. Choose the **git** option to connect your GitHub repository.
44+
45+
## Step 4: Select Your Zola Repository
46+
47+
1. From the list of repositories, select the repository where your Zola project is located.
48+
49+
## Step 5: Automatic Deployment
50+
51+
Zeabur will automatically detect that you're deploying a Zola project and will handle the deployment process for you without any additional configuration needed.
52+
53+
To use a specific version of Zola, set [`ZOLA_VERSION`](https://zeabur.com/docs/environment/variables) environment variable in project settings to a valid
54+
release tag, for example `0.17.2`.
55+
56+
## Step 6: Domain Binding
57+
58+
1. Once the deployment is complete, bind a domain name to your service.
59+
2. You can choose to use a free `.zeabur.app` subdomain or bind your own custom domain.
60+
3. Zeabur will automatically provide a free SSL certificate for your domain, ensuring secure browsing for your visitors.
61+
62+
## Step 7: Your Site is Live!
63+
64+
Congratulations! Your Zola site is now deployed and live, served through Zeabur's edge network.
65+
66+
You can now visit your website at the domain you've set up.

0 commit comments

Comments
 (0)