Skip to content

Commit

Permalink
Add Zeabur deployment guide (#2408)
Browse files Browse the repository at this point in the history
* Add Zeabur deployment guide

* Select Zola version in Zeabur deployment
  • Loading branch information
yuaanlin authored Jan 15, 2024
1 parent 52b29df commit 9fe4558
Showing 1 changed file with 66 additions and 0 deletions.
66 changes: 66 additions & 0 deletions docs/content/documentation/deployment/zeabur.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
+++
title = "Zeabur"
weight = 50
+++

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!

## Prerequisites

- A Zola site project on your local machine.
- A GitHub account and your Zola site project repository hosted on GitHub.
- A Zeabur account. If you don't have one, sign up at [here](https://zeabur.com/login).

## Step 1: Create a Project on Zeabur

1. Log in to your Zeabur account.
2. Navigate to the dashboard and click on the **Create Project** button.
3. Follow the on-screen instructions to set up a new project.

## Step 2: Push Your Zola Files to GitHub

1. Initialize a Git repository in your Zola project folder if you haven't already:

```bash
git init
git add .
git commit -m "Initial commit"
```

2. Push your Zola project to GitHub:

```bash
git remote add origin <your-github-repo-url>
git branch -M main
git push -u origin main
```

Replace `<your-github-repo-url>` with the URL of your GitHub repository.

## Step 3: Create a Service on Zeabur

1. Back in your Zeabur dashboard, click on **Create Service**.
2. Choose the **git** option to connect your GitHub repository.

## Step 4: Select Your Zola Repository

1. From the list of repositories, select the repository where your Zola project is located.

## Step 5: Automatic Deployment

Zeabur will automatically detect that you're deploying a Zola project and will handle the deployment process for you without any additional configuration needed.
To use a specific version of Zola, set [`ZOLA_VERSION`](https://zeabur.com/docs/environment/variables) environment variable in project settings to a valid
release tag, for example `0.17.2`.
## Step 6: Domain Binding
1. Once the deployment is complete, bind a domain name to your service.
2. You can choose to use a free `.zeabur.app` subdomain or bind your own custom domain.
3. Zeabur will automatically provide a free SSL certificate for your domain, ensuring secure browsing for your visitors.
## Step 7: Your Site is Live!
Congratulations! Your Zola site is now deployed and live, served through Zeabur's edge network.

You can now visit your website at the domain you've set up.

0 comments on commit 9fe4558

Please sign in to comment.