Installation

Zola provides pre-built binaries for MacOS, Linux and Windows on the GitHub release page.

Debian

Zola is available over at barnumbirr/zola-debian. Grab the latest .deb for your Debian version then simply run:

# sudo dpkg -i zola_<version>_amd64_debian_<debian_version>.deb

macOS

Zola is available on Brew:

# brew install zola

Zola is also available on MacPorts:

# sudo port install zola

Arch Linux

Zola is available in the official Arch Linux repositories.

# pacman -S zola

Alpine Linux

Zola is available in the official Alpine Linux community repository since Alpine v3.13.

See this section of the Alpine Wiki explaining how to enable the community repository if necessary: https://wiki.alpinelinux.org/wiki/Repositories#Enabling_the_community_repository

# apk add zola

Fedora

On Fedora, Zola is avialable via COPR.

# sudo dnf copr enable fz0x1/zola
# sudo dnf install zola

Void Linux

Zola is available in the official Void Linux repositories.

# sudo xbps-install zola

FreeBSD

Zola is available in the official package repository.

# pkg install zola

OpenBSD

Zola is available in the official package repository.

# doas pkg_add zola

pkgsrc

Zola is available in the official package repository, with pkgin.

# pkgin install zola

Snapcraft

Zola is available on snapcraft:

# snap install --edge zola

Flatpak

Zola is available as a flatpak on flathub:

# flatpak install flathub org.getzola.zola

To use zola:

# flatpak run org.getzola.zola [command]

To avoid having to type this every time, an alias can be created in ~/.bashrc:

# alias zola="flatpak run org.getzola.zola"

NixOS / Nixpkgs

Zola is available in the nixpkgs repository. If you’re using NixOS, you can install Zola by adding the following to /etc/nixos/configuration.nix:

environment.systemPackages = [
  pkgs.zola
];

If you’re using Nix as a package manager in another OS, you can install it using:

nix-env -iA nixpkgs.zola

Via Github Actions

Zola can be installed in a GHA workflow with taiki-e/install-action. Simply add it in your CI config, for example:

jobs:
  foo:
    steps:
      - uses: taiki-e/install-action@v2
        with:
          tool: zola@0.17.1
      # ...

See the action repo for docs and more examples.

Docker

Zola is available on the GitHub registry. It has no latest tag, you will need to specify a specific version to pull.

# docker pull ghcr.io/getzola/zola:v0.17.1

Build

# docker run -u "#(id -u):#(id -g)" -v #PWD:/app --workdir /app ghcr.io/getzola/zola:v0.17.1 build

Serve

# docker run -u "#(id -u):#(id -g)" -v #PWD:/app --workdir /app -p 8080:8080 ghcr.io/getzola/zola:v0.17.1 serve --interface 0.0.0.0 --port 8080 --base-url localhost

You can now browse http://localhost:8080.

To enable live browser reload, you may have to bind to port 1024. Zola searches for an open port between 1024 and 9000 for live reload. The new docker command would be # docker run -u "#(id -u):#(id -g)" -v #PWD:/app --workdir /app -p 8080:8080 -p 1024:1024 ghcr.io/getzola/zola:v0.17.1 serve --interface 0.0.0.0 --port 8080 --base-url localhost

Windows

Zola is available on Scoop:

# scoop install zola

and Chocolatey:

# choco install zola

Zola does not work in PowerShell ISE.

From source

To build Zola from source, you will need to have Git, Rust and Cargo installed. You will also need to meet additional dependencies to compile libsass:

OSX, Linux and other Unix-like operating systems: make (gmake on BSDs), g++, libssl-dev
- NixOS: Create a shell.nix file in the root of the cloned project with the following contents:
```
 with import <nixpkgs> {};

 pkgs.mkShell {
   buildInputs = [
     libsass
     openssl
     pkgconfig
  ];
 }
```
- Then, invoke nix-shell. This opens a shell with the above dependencies. Then, run cargo build --release to build the project.
Windows (a bit trickier): updated MSVC and overall updated VS installation

From a terminal, you can now run the following command:

# cargo build --release

If you encountered compilation errors like error: failed to run custom build command for 'ring v0.16.20', you can try the command below instead:

# cargo build --release --no-default-features --features=native-tls

The binary will be available in the target/release directory. You can move it in your #PATH to have the zola command available globally or in a directory if you want for example to have the binary in the same repository as the site.