Added mirror page

This commit is contained in:
ngn 2024-01-12 14:37:13 +03:00
parent 5e4d1bc0b6
commit 2994d22636
4 changed files with 55 additions and 4 deletions

View File

@ -9,7 +9,7 @@ don't have a link yet.
| --------------------------- | ----------------------------------------------- |
| Introduction | Learn about MatterLinux and other general stuff |
| Installation | Learn how to install a base MatterLinux system |
| Installation (Any% Edition) | TLDR for the Installation page |
| Installation (Any% Edition) | Speedrunner edition of the Installation page |
| Post-Installation | Make your system (somewhat) usable |
## Packaging
@ -18,7 +18,7 @@ don't have a link yet.
| [Repo](wiki/repo) | Learn about MatterLinux repos and how they work |
| [Package](wiki/package) | Learn about MatterLinux packages |
| [Package Management](wiki/package_man) | Learn about MatterLinux package manager |
| Mirrors | Discover repo mirrors and learn how you can setup one |
| [Mirrors](wiki/mirrors) | Discover repo mirrors and learn how you can setup one |
## Other
| Name | Description |

6
wiki/mirrors.json Normal file
View File

@ -0,0 +1,6 @@
{
"id": "mirrors",
"title": "Mirrors",
"author": "ngn",
"date": "12/01/24"
}

45
wiki/mirrors.md Normal file
View File

@ -0,0 +1,45 @@
Mirrors are web and FTP servers that mirror repos from the official repo web server.
# Usage
To use a mirror with `mp`, change the repo URI for the target repo in your `mp`
configuration file (`/etc/mp/cfg`).
### Creating a mirror
To create a mirror you can use the `matter-mirror` tool. This tool is included
with the `matter-tools` repository. To install it [see the project READMDE](https://git.matterlinux.xyz/Matter/matter-tools#installation).
After installing `matter-mirror`, specify an URI and an output directory (files will be downloaded
into the output directory). For example to mirror the `base` repo from
`https://pkgs.matterlinux.xyz/base` to `base_mirror` directory:
```
$ mkdir base_mirror
$ matter-mirror -u https://pkgs.matterlinux.xyz/base -o base_mirror
```
To serve the mirror, you can setup a web server such as `nginx`, or you can setup a FTP
server such as `pure-ftpd`.
You will mostly likely want to update your mirror every once in a while. To do so you can
create a cron job. For example to update your mirror every day at 00:00, you can add the
following entry to your `/etc/crontab`:
```
0 0 * * * <user> matter-mirror -u <url> -o <output dir path>
```
# List
This section contains information about different MatterLinux repo and mirros
that you can use. To add your mirror to this list get in contact with the maintainer/developers.
Note that official mirrors are **ALWAYS** signed with the `F9E70878C2FB389AEC2BA34CA3654DF5AD9F641D`
fingerprint (belongs to the maintainer, ngn). If syncing with a mirror tells you otherwise, then
**DO NOT USE THAT MIRROR** and report it to the maintainer/developers in order to remove it
from the list.
### Official repos
| Repo | URI | Location |
| ------- | -------------------------------------- | ----------- |
| base | `https://pkgs.matterlinux.xyz/base` | 🇹🇷 Turkey |
| desktop | `https://pkgs.matterlinux.xyz/desktop` | 🇹🇷 Turkey |
### Mirrors
Currently there are no available mirrors.

View File

@ -96,13 +96,13 @@ used for building MatterLinux repos. To do so please follow the steps [here](htt
Finally to build the repo:
```
mp-repo <repo dir>
$ mp-repo <repo dir>
```
You will mostly likely want to disable package signing though, as you are probably not the
owner of the repo:
```
mp-repo --no-sign <repo dir>
$ mp-repo --no-sign <repo dir>
```
### Creating a new repo