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 | | Introduction | Learn about MatterLinux and other general stuff |
| Installation | Learn how to install a base MatterLinux system | | 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 | | Post-Installation | Make your system (somewhat) usable |
## Packaging ## Packaging
@ -18,7 +18,7 @@ don't have a link yet.
| [Repo](wiki/repo) | Learn about MatterLinux repos and how they work | | [Repo](wiki/repo) | Learn about MatterLinux repos and how they work |
| [Package](wiki/package) | Learn about MatterLinux packages | | [Package](wiki/package) | Learn about MatterLinux packages |
| [Package Management](wiki/package_man) | Learn about MatterLinux package manager | | [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 ## Other
| Name | Description | | 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: 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 You will mostly likely want to disable package signing though, as you are probably not the
owner of the repo: owner of the repo:
``` ```
mp-repo --no-sign <repo dir> $ mp-repo --no-sign <repo dir>
``` ```
### Creating a new repo ### Creating a new repo