2017-09-12 07:13:26 +00:00
|
|
|
+++
|
|
|
|
title = "Installation"
|
2017-09-27 14:37:17 +00:00
|
|
|
weight = 1
|
2017-09-12 07:13:26 +00:00
|
|
|
+++
|
|
|
|
|
2018-10-18 21:09:32 +00:00
|
|
|
Zola provides pre-built binaries for MacOS, Linux and Windows on the
|
|
|
|
[GitHub release page](https://github.com/getzola/zola/releases).
|
2017-09-27 14:37:17 +00:00
|
|
|
|
2018-11-19 15:34:39 +00:00
|
|
|
## Linux
|
|
|
|
|
2018-11-19 15:36:07 +00:00
|
|
|
### Arch Linux
|
2017-09-27 14:37:17 +00:00
|
|
|
|
2018-11-12 18:58:46 +00:00
|
|
|
Use your favourite AUR helper to install the `zola-bin` package.
|
2017-10-16 13:22:47 +00:00
|
|
|
|
2017-11-01 15:31:58 +00:00
|
|
|
```bash
|
2018-11-19 16:27:15 +00:00
|
|
|
$ yay -S zola-bin
|
2017-11-01 15:31:58 +00:00
|
|
|
```
|
2017-09-27 14:37:17 +00:00
|
|
|
|
2018-11-19 15:34:39 +00:00
|
|
|
### Snapcraft
|
|
|
|
|
|
|
|
Zola is available on snapcraft:
|
|
|
|
|
|
|
|
```bash
|
2018-11-29 05:16:40 +00:00
|
|
|
$ snap install --edge --classic zola
|
2018-11-19 15:34:39 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
## Windows
|
|
|
|
|
|
|
|
Zola is available on [Scoop](http://scoop.sh):
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ scoop install zola
|
|
|
|
```
|
|
|
|
|
|
|
|
And [Chocolatey](https://chocolatey.org/):
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ choco install zola
|
|
|
|
```
|
|
|
|
|
2018-11-12 18:58:46 +00:00
|
|
|
## From source
|
|
|
|
To build it from source, you will need to have Git, [Rust (at least 1.28) and Cargo](https://www.rust-lang.org/)
|
|
|
|
installed. You will also need additional dependencies to compile [libsass](https://github.com/sass/libsass):
|
2017-09-27 14:37:17 +00:00
|
|
|
|
2018-11-12 18:58:46 +00:00
|
|
|
- OSX, Linux and other Unix: `make` (`gmake` on BSDs), `g++`, `libssl-dev`
|
|
|
|
- Windows (a bit trickier): updated `MSVC` and overall updated VS installation
|
|
|
|
|
|
|
|
From a terminal, you can now run the following command:
|
2017-10-16 13:22:47 +00:00
|
|
|
|
2017-10-21 07:48:29 +00:00
|
|
|
```bash
|
2018-11-12 18:58:46 +00:00
|
|
|
$ cargo build --release
|
2017-10-21 07:48:29 +00:00
|
|
|
```
|
2017-09-27 14:37:17 +00:00
|
|
|
|
2018-11-12 18:58:46 +00:00
|
|
|
The binary will be available in the `target/release` folder. 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.
|
2018-11-12 08:20:37 +00:00
|
|
|
|
|
|
|
|
2018-11-12 18:58:46 +00:00
|
|
|
## Older versions (Gutenberg)
|
|
|
|
Before 0.5, Zola was called Gutenberg. Since the process of updating package managers to Zola is on-going, you can still
|
|
|
|
download previous versions of Gutenberg on your package manager of choice in the meantime.
|
2017-09-27 14:37:17 +00:00
|
|
|
|
2018-11-12 18:58:46 +00:00
|
|
|
### macOS
|
|
|
|
|
|
|
|
Gutenberg is available on [Brew](https://brew.sh):
|
2017-10-16 13:22:47 +00:00
|
|
|
|
|
|
|
```bash
|
2018-11-12 18:58:46 +00:00
|
|
|
$ brew install gutenberg
|
2017-10-16 13:22:47 +00:00
|
|
|
```
|
2017-09-27 14:37:17 +00:00
|
|
|
|
2018-11-12 18:58:46 +00:00
|
|
|
### Windows
|
2017-11-09 02:39:09 +00:00
|
|
|
|
2018-11-12 18:58:46 +00:00
|
|
|
Gutenberg is available on [Scoop](http://scoop.sh):
|
2017-11-09 02:39:09 +00:00
|
|
|
|
|
|
|
```bash
|
2018-11-12 18:58:46 +00:00
|
|
|
$ scoop install gutenberg
|
2017-11-09 02:39:09 +00:00
|
|
|
```
|
|
|
|
|
2018-11-12 18:58:46 +00:00
|
|
|
And [Chocolatey](https://chocolatey.org/):
|
2018-09-18 10:13:00 +00:00
|
|
|
|
2018-11-12 18:58:46 +00:00
|
|
|
```bash
|
|
|
|
$ choco install gutenberg
|
|
|
|
```
|
2017-09-27 14:37:17 +00:00
|
|
|
|
2018-11-12 18:58:46 +00:00
|
|
|
### Arch Linux
|
|
|
|
|
|
|
|
Use your favourite AUR helper to install the `gutenberg-bin` package.
|
2017-09-27 14:37:17 +00:00
|
|
|
|
|
|
|
```bash
|
2018-11-12 18:58:46 +00:00
|
|
|
$ yaourt -S gutenberg-bin
|
2017-09-27 14:37:17 +00:00
|
|
|
```
|
|
|
|
|
2018-11-12 18:58:46 +00:00
|
|
|
### Void Linux
|
|
|
|
|
|
|
|
From the terminal, run the following command:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ xbps-install -S gutenberg
|
|
|
|
```
|