Deploy the Halo open source site builder-Simple Application Server(SAS)-阿里云帮助中心

Halo is an open source site builder with a rich library of themes and plugins. You can use the Halo application image to quickly deploy the Halo site builder.

Note

For more information about Halo, see the official Halo website.

Procedure

Step 1: Deploy Halo

Important

If you have already purchased a Simple Application Server instance, you can deploy Halo by resetting the server. When you reset the server, select the Halo image from the application images. Resetting the server clears all data on the system disk. Back up your data as needed. For more information, see Reset a simple application server.

Go to the Servers page in the Simple Application Server console.
In the middle of the page, click Create Server.

On the Simple Application Server page, follow the prompts to configure the resources. The following table describes the configuration items.

Note

The available images and plans may vary based on the region and instance type. The options on the purchase page in the console take precedence.

Configuration Item	Example	Description
Region	Singapore	Select a region that is close to your target users to reduce network latency. You cannot change the region after the server is created. Choose the region with caution. Important Simple Application Server instances in regions outside the Chinese mainland, such as China (Hong Kong) and Singapore, use international bandwidth. High network latency may occur when these servers are accessed from the Chinese mainland. We recommend that you select the region closest to your target users to improve access speed. For more information, see Regions and network connectivity.
Servers	Instance family: General-purpose Plan: CNY 56/month	Select an instance family: Options include General-purpose, Multiple-IP, International, and Larger-capacity. For information about the scenarios and features of different instance families, see Instance families. Select a plan: Click to view more plans. A plan includes specifications for vCPUs, memory, the system disk, and the data transfer plan. For more information, see Instance specifications. Important To create a server that runs a Windows image, select a plan that provides a system disk larger than 40 GiB.
Image	Application Images: Halo Tag: Halo 2.20.14	On the Application Images tab, click Expand Other Images, and select Halo.
Purchase Settings	Quantity: 1 Duration: 1 Month	Quantity: The number of servers to purchase. The default value is 1. Duration: The subscription duration. The default value is 1 month. Important If your instance is used for web services in the Chinese mainland, you must complete an ICP filing. The subscription duration, including renewals, for an instance that requires an ICP filing must be 3 months or longer. For more information, see File for an ICP number for a domain name. Monthly subscription: 1 month, 3 months, or 6 months. Yearly subscription: 1 year, 2 years, or 3 years. By default, the Auto-renewal feature is enabled to prevent business interruptions that are caused by subscription expiration. For more information, see Auto-renewal. Monthly subscription: The renewal period is 1 month. Yearly subscription: The renewal period is 1 year.

After you complete the configuration, click Buy Now and follow the on-screen instructions to complete the payment.
When the server status changes from Pending to Running, the Halo server is created.

Step 2: Log on to the Halo admin console

Obtain the Halo logon information.
1. On the Servers page, click the ID of the target server to go to the Server Overview page.
2. Click the Application Details tab to obtain the Halo home page URL and admin logon URL.
  Note
  On the Application Details tab, you can view the steps for using Halo and the installation paths of pre-installed applications.
  - Halo site home page URL: http://118.178.XX.XX.
  - Halo admin logon URL: http://118.178.XX.XX/console.
Log on to the Halo admin console.
1. In a browser, enter the Halo admin console URL: http://118.178.XX.XX/console.
2. (Conditional) Initialize the system.
  When you log on to the Halo site for the first time, the System Initialization page appears. Configure parameters such as Site Title, Username, Email, and Password as prompted, and then click Initialize.
3. On the Halo logon page, enter your username and password, and then click Log On.
4. After you log on, the Halo admin console appears. You can install themes and plugins and customize configurations as needed. For more information, see the official Halo documentation.

Step 3: Access the Halo home page

In a browser, enter the Halo home page URL http://118.178.XX.XX to access the Halo home page.

FAQ

How do I upgrade Halo?

Check for new Halo versions.
1. Log on to the Halo admin console. In the dialog box that appears in the upper-right corner of the dashboard, click View Details.
  When a new version of Halo is available, a notification is pushed to the Halo admin console. In this example, the new version is 2.21.5.
2. On the Update Log page, check the latest Docker image version for Halo deployment.
In the Halo admin console, back up your data.
Download the backup data to your computer. This lets you promptly recover the data if the upgrade fails.
Upgrade Halo.
1. Remotely connect to the server where Halo is deployed.
2. Run the following command to modify the Halo image version in the configuration file:
```
sudo vi /opt/halo/docker-compose.yml
```
  Press the i key to enter edit mode. In this example, change the Halo image version from 2.20 to 2.21.5.
  Press the Esc key, enter :wq, and then press the Enter key to save the file and exit.
3. Run the following commands to run the container:
```
cd /opt/halo
sudo docker compose up -d
```
Verify the result.
In the Halo admin console, click Overview. The version is updated.

References

You can use a domain name to access your Halo site for improved security and convenience. For more information, see Register and parse a domain name.
If you have attached a domain name to the server, you can configure HTTPS encrypted access for the domain name. This lets you switch the data transmission protocol from HTTP to HTTPS at a low cost. This change enables identity verification and encrypted data transmission for your site, which prevents data tampering and information leaks during transmission. For more information, see Deploy an SSL certificate.
You can also use WordPress to build an open source site. WordPress provides common application templates for building websites. This helps you quickly build sites that meet your business needs, such as corporate websites, news sites, blogs, forums, and e-commerce platforms. For more information, see Use a WordPress application image to quickly build a website.