zola/docs/content/documentation/getting-started/installation.md
photong 51d4b6bd6a Simple clean up of documentation. (#849)
* Update installation.md

* Update cli-usage.md

* Update installation.md

* Update directory-structure.md

* Update configuration.md

* Update overview.md

* Update section.md

* Update page.md

* Update section.md

* Update configuration.md

* Update page.md

* Update section.md

* Update page.md

* Update shortcodes.md

* Update linking.md

* Update table-of-contents.md

* Update syntax-highlighting.md

* Update taxonomies.md

* Update search.md

* Update sass.md

* Update index.md

* Update multilingual.md

* Update overview.md

* Update pages-sections.md

* Update pagination.md

* Update taxonomies.md

* Update rss.md

* Update sitemap.md

* Update robots.md

* Update 404.md

* Update archive.md

* Update overview.md

* Update installing-and-using-themes.md

* Update creating-a-theme.md

* Update netlify.md

* Update github-pages.md

* Update gitlab-pages.md

* Update index.md

* Update page.md

* Update section.md

* Updates.
2020-02-02 17:48:42 -08:00

2 KiB

+++ title = "Installation" weight = 1 +++

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

macOS

Zola is available on Brew:

$ brew install zola

Arch Linux

Use your favourite AUR helper to install the zola-bin package.

$ yay -S zola-bin

Fedora

Zola has been available in the official repositories since Fedora 29.

$ sudo dnf install zola

FreeBSD

Zola is available in the official package repository.

$ pkg install zola

Snapcraft

Zola is available on snapcraft:

$ snap install --edge zola

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 (at least 1.36) 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

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.