You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Install Hugo by following the instructions [here](https://gohugo.io/installation/).
14
14
15
-
- Start a local server from the root of this repository:
16
-
```bash
17
-
hugo server
18
-
```
19
-
20
-
### Using Docker Compose
15
+
> [!NOTE]
16
+
> Currently recommended versions are:
17
+
> - hugo: **0.155.0+**
18
+
> - docsy: **0.13.0+**
21
19
22
-
- Install docker-compose by following the instructions [here](https://docs.docker.com/compose/install/).
20
+
### Using Hugo
23
21
24
-
-Start a local server from the root of this repository:
22
+
Start a local server from the root of this repository:
25
23
26
24
```bash
27
-
docker-compose up -d
25
+
hugo server
28
26
```
29
27
30
-
Now go to [http://localhost:1313](http://localhost:1313) on your browser. Once you make any changes to the code the changes are compiled in real-time and you can see those in the browser.
28
+
### Using Docker
29
+
30
+
1. Create a cache directory for Hugo:
31
+
```bash
32
+
mkdir -p $HOME/.cache/hugo_cache
33
+
```
34
+
35
+
2. Start a local server from the root of this repository:
36
+
```bash
37
+
docker run --rm -v .:/site -v $HOME/.cache/hugo_cache:/cache -u $(id -u):$(id -g) -w /site -p 1313:1313 ghcr.io/gohugoio/hugo:latest server --bind="0.0.0.0"
38
+
```
39
+
40
+
### Using Docker Compose
41
+
42
+
1. Install docker-compose by following the instructions [here](https://docs.docker.com/compose/install/).
43
+
44
+
2. Export variables for user and group id:
45
+
46
+
```bash
47
+
export UID=$(id -u)
48
+
export GID=$(id -g)
49
+
```
50
+
51
+
3. Create a cache directory for Hugo:
52
+
53
+
To prevent ownership and permission problems, create the Hugo cache directory and ignore the error if the directory
54
+
already exists:
55
+
56
+
```bash
57
+
mkdir -p $HOME/.cache/hugo_cache
58
+
```
59
+
60
+
4. Start a local server from the root of this repository:
61
+
62
+
```bash
63
+
docker-compose up -d
64
+
```
65
+
66
+
Now go to [http://localhost:1313](http://localhost:1313) on your browser. Once you make any changes to the code the
67
+
changes are compiled in real-time and you can see those in the browser.
0 commit comments