docs/content/documentation/getting-started/installation.md
+++ title = "Installation" weight = 10 +++
Zola provides pre-built binaries for MacOS, Linux and Windows on the GitHub release page.
Zola is available on Brew:
$ brew install zola
Zola is also available on MacPorts:
$ sudo port install zola
Zola is available in the official Arch Linux repositories.
$ pacman -S zola
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
Zola is available from the pkg.haus APT archive for Debian stable, testing and unstable on amd64 and arm64, built from source at release tags. Set up the archive per the instructions on pkg.haus, then run:
$ sudo apt install zola
Zola is available via GURU.
See the end user documentation for how to enable the GURU repository. Afterwards simply run:
$ sudo emerge --ask www-apps/zola
Zola is available in the official Void Linux repositories.
$ sudo xbps-install zola
Zola is available in the official package repository.
$ pkg install zola
Zola is available in the official package repository.
$ doas pkg_add zola
Zola is available in the official openSUSE Tumbleweed main OSS repository.
$ sudo zypper install zola
Zola is available in the official experimental utilities repository.
$ sudo zypper addrepo https://download.opensuse.org/repositories/utilities/15.6/utilities.repo
$ sudo zypper refresh
$ sudo zypper install zola
Zola is available in the official package repository, with pkgin.
$ pkgin install zola
Zola is available on snapcraft:
$ snap install --edge zola
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"
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
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: [email protected]
# ...
See the action repo for docs and more examples.
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.19.1
$ docker run -u "$(id -u):$(id -g)" -v $PWD:/app --workdir /app ghcr.io/getzola/zola:v0.19.1 build
$ docker run -u "$(id -u):$(id -g)" -v $PWD:/app --workdir /app -p 8080:8080 ghcr.io/getzola/zola:v0.19.1 serve --interface 0.0.0.0 --port 8080 --base-url localhost
You can now browse http://localhost:8080.
Since there is no shell in the Zola docker image, if you want to use it from inside a Dockerfile, you have to use the
exec form of RUN, like:
FROM ghcr.io/getzola/zola:v0.19.1 as zola
COPY . /project
WORKDIR /project
RUN ["zola", "build"]
Zola could be installed using official Winget command:
$ winget install getzola.zola
Also it is available on Scoop:
$ scoop install zola
and Chocolatey:
$ choco install zola
Zola does not work in PowerShell ISE.
To build Zola from source, you will need:
From a terminal, you can now run the following commands:
$ cargo install --locked --git https://github.com/getzola/zola
$ zola --version
Cargo will install the zola binary in ~/.cargo/bin/.
You can move it into the repository of your site if you want.