Skip to content

Commit 9cb8b44

Browse files
authored
chore: update the readme
1 parent 17511db commit 9cb8b44

File tree

1 file changed

+49
-0
lines changed

1 file changed

+49
-0
lines changed

README.md

+49
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,51 @@
11
# manjaro-package-mirror
22
Docker container which mirrors manjaro packages and serves them via nginx
3+
4+
This image is based on the alpine image and uses rsync to synchronize the packages and nginx to deliver them
5+
6+
## Supported Architectures
7+
The image is built for the **amd64** and **arm64** platform and is available in the **DockerHub** and the **Github Container Registry** respectively.
8+
9+
## Parameters
10+
A container can be started with various parameters to make changes to the default configuration, expose ports, and persist data. For example, `-p 8080:80` would expose port 80 inside the container for access from outside via port 8080. The following parameters are available for this image:
11+
12+
| Parameter | Function |
13+
| -------------------------------------------------------------------- | ----------------------------------------------------------- |
14+
| `-p 8080:80` | Binds container port 80 to host port 8080 |
15+
| `-v /path/to/storage:/srv/http/manjaro` | Persists the package repository data under /path/to/storage |
16+
| `-e SOURCE_MIRROR=rsync://mirrorservice.org/repo.manjaro.org/repos/` | Allows to use another mirror for synchronization |
17+
| `-e SLEEP=6h` | Adjusts the pause time between synchronizations |
18+
19+
## Usage
20+
The container can be started either with `docker run` or `docker-compose`
21+
22+
**Please make sure to choose a suitable directory for persistence before running the container and replace the placeholder "/path/to/storage" chosen here with it.**
23+
24+
### docker-compose (recommended)
25+
````yaml
26+
---
27+
version: "3.4"
28+
services:
29+
manjaro-mirror:
30+
container_name: manjaro-mirror
31+
image: ghcr.io/twiese99/manjaro-package-mirror
32+
volumes:
33+
- /path/to/storage:/srv/http/manjaro
34+
ports:
35+
- 8080:80
36+
restart: unless-stopped
37+
````
38+
39+
### docker run
40+
````bash
41+
docker run -d \
42+
--name=manjaro-mirror \
43+
-p 8080:80 \
44+
-v /path/to/storage:/srv/http/manjaro \
45+
--restart unless-stopped \
46+
ghcr.io/twiese99/manjaro-package-mirror
47+
````
48+
49+
50+
51+

0 commit comments

Comments
 (0)