You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

installation.md 1.7KB

6 years ago
6 years ago
5 years ago
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677
  1. +++
  2. title = "Installation"
  3. weight = 1
  4. +++
  5. Zola provides pre-built binaries for MacOS, Linux and Windows on the
  6. [GitHub release page](https://github.com/getzola/zola/releases).
  7. ### macOS
  8. Zola is available on [Brew](https://brew.sh):
  9. ```bash
  10. $ brew install zola
  11. ```
  12. ### Arch Linux
  13. Use your favourite AUR helper to install the `zola-bin` package.
  14. ```bash
  15. $ yay -S zola-bin
  16. ```
  17. ### Snapcraft
  18. Zola is available on snapcraft:
  19. ```bash
  20. $ snap install --edge zola
  21. ```
  22. ## Windows
  23. Zola is available on [Scoop](http://scoop.sh):
  24. ```bash
  25. $ scoop install zola
  26. ```
  27. And [Chocolatey](https://chocolatey.org/):
  28. ```bash
  29. $ choco install zola
  30. ```
  31. Zola does not work in PowerShell ISE.
  32. ## From source
  33. To build it from source, you will need to have Git, [Rust (at least 1.31) and Cargo](https://www.rust-lang.org/)
  34. installed. You will also need additional dependencies to compile [libsass](https://github.com/sass/libsass):
  35. - OSX, Linux and other Unix: `make` (`gmake` on BSDs), `g++`, `libssl-dev`
  36. - NixOS: Create a `shell.nix` file in the root of the cloned project with the following contents:
  37. ```nix
  38. with import <nixpkgs> {};
  39. pkgs.mkShell {
  40. buildInputs = [
  41. libsass
  42. openssl
  43. pkgconfig
  44. ];
  45. }
  46. ```
  47. - Then invoke `nix-shell`. This opens a shell with the above dependencies. You then run `cargo build --release` to build the project.
  48. - Windows (a bit trickier): updated `MSVC` and overall updated VS installation
  49. From a terminal, you can now run the following command:
  50. ```bash
  51. $ cargo build --release
  52. ```
  53. The binary will be available in the `target/release` folder. You can move it in your `$PATH` to have the
  54. `zola` command available globally or in a directory if you want for example to have the binary in the
  55. same repository as the site.