fix: pool entry headers
This commit is contained in:
parent
0526bf9c0b
commit
6e8247b5f6
@ -4,32 +4,32 @@ On this page, you will find information about MatterLinux package pools.
|
||||
Here is a list of all the official MatterLinux software package pools, you can
|
||||
find URL(s) for these pools in the [mirrors page](/wiki/mirrors).
|
||||
|
||||
# Base
|
||||
### Base
|
||||
- **Name**: base
|
||||
- **Signed with**: `F9E70878C2FB389AEC2BA34CA3654DF5AD9F641D`
|
||||
- **Maintainer**: ngn | [Email](mailto:ngn@ngn.tf) [PGP](https://keys.openpgp.org/pks/lookup?op=get&options=mr&search=0xF9E70878C2FB389AEC2BA34CA3654DF5AD9F641D)
|
||||
- **Maintainer**: ngn | [Email](mailto:ngn@ngn.tf) [PGP](https://keys.openpgp.org/pks/lookup?op=get&options=mr&search=0xF9E70878C2FB389AEC2BA34CA3654DF5AD9F641D)
|
||||
|
||||
Contains software packages for the core system (for example `glibc`, `grub`),
|
||||
so you need these packages in order to have a bootable system, however the base
|
||||
pool alone won't get you further from a simple installation.
|
||||
|
||||
# Desktop
|
||||
- **Name**: desktop
|
||||
### Desktop
|
||||
- **Name**: desktop
|
||||
- **Signed with**: `F9E70878C2FB389AEC2BA34CA3654DF5AD9F641D`
|
||||
- **Maintainer**: ngn | [Email](mailto:ngn@ngn.tf) [PGP](https://keys.openpgp.org/pks/lookup?op=get&options=mr&search=0xF9E70878C2FB389AEC2BA34CA3654DF5AD9F641D)
|
||||
- **Maintainer**: ngn | [Email](mailto:ngn@ngn.tf) [PGP](https://keys.openpgp.org/pks/lookup?op=get&options=mr&search=0xF9E70878C2FB389AEC2BA34CA3654DF5AD9F641D)
|
||||
|
||||
Contains software packages for your desktop needs (for example `xorg`, `xfce4`),
|
||||
however they are not necessarily needed for a simple installation.
|
||||
|
||||
# Server
|
||||
- **Name**: desktop
|
||||
### Server
|
||||
- **Name**: desktop
|
||||
- **Signed with**: `F9E70878C2FB389AEC2BA34CA3654DF5AD9F641D`
|
||||
- **Maintainer**: ngn | [Email](mailto:ngn@ngn.tf) [PGP](https://keys.openpgp.org/pks/lookup?op=get&options=mr&search=0xF9E70878C2FB389AEC2BA34CA3654DF5AD9F641D)
|
||||
- **Maintainer**: ngn | [Email](mailto:ngn@ngn.tf) [PGP](https://keys.openpgp.org/pks/lookup?op=get&options=mr&search=0xF9E70878C2FB389AEC2BA34CA3654DF5AD9F641D)
|
||||
|
||||
Contains software packages for your server needs (for example `apache`, `nginx`),
|
||||
similar to the `desktop` pool, you do not necessarily need these for a simple installation.
|
||||
|
||||
# Structure
|
||||
# Structure
|
||||
A pool contains:
|
||||
|
||||
- [Packages](/wiki/packages) (`.mpf` files)
|
||||
@ -38,7 +38,7 @@ A pool contains:
|
||||
- Package list file (`LIST`)
|
||||
|
||||
### Package files and signatures
|
||||
MatterLinux pools contain at least two packages. Each package also has a PGP signature
|
||||
MatterLinux pools contain at least two packages. Each package also has a PGP signature
|
||||
that can be used to verify the package. These signatures belong to public key fingerprint
|
||||
specified in the pool info file.
|
||||
|
||||
@ -49,7 +49,7 @@ Pool info file contains information about the pool itself. This information incl
|
||||
- Pool maintainer
|
||||
- Pool public key (used for package signatures)
|
||||
|
||||
This info file can be found in the at the root of the pool. For example the pool info file
|
||||
This info file can be found in the at the root of the pool. For example the pool info file
|
||||
for `https://pkgs.matterlinux.xyz/base` is located at `https://pkgs.matterlinux.xyz/base/INFO`.
|
||||
`.ini` format is used for this file.
|
||||
|
||||
@ -61,10 +61,10 @@ is located at `https://pkgs.matterlinux.xyz/base/LIST`.
|
||||
This archive has the following structure:
|
||||
```
|
||||
list
|
||||
├── package-one_version
|
||||
├── package-one_version
|
||||
│ └── DATA
|
||||
├── package-two_version
|
||||
│ └── DATA
|
||||
│ └── DATA
|
||||
...
|
||||
```
|
||||
The `DATA` file contains the information for that specific package and it's extracted from packages.
|
||||
@ -72,7 +72,7 @@ To learn more about these please check out the page for [packages](/wiki/package
|
||||
|
||||
### Pool sources
|
||||
Source for a pool has a simple structure. It also contains all the source files for all the packages in
|
||||
that pool. For example lets take a look the structure of the [`base`](https://pkgs.matterlinux.xyz/base)
|
||||
that pool. For example lets take a look the structure of the [`base`](https://pkgs.matterlinux.xyz/base)
|
||||
pool source:
|
||||
```
|
||||
base
|
||||
@ -109,26 +109,26 @@ Let's break this down:
|
||||
- `LICENSE.txt`: License used for the pool. **All the packages in the pool should use a license
|
||||
compatible with this license.**
|
||||
- `README.md`: README file. Contains a small description about the pool.
|
||||
- `pool.sh`: Pool script contains information about the pool, used to build the
|
||||
- `pool.sh`: Pool script contains information about the pool, used to build the
|
||||
pool info file.
|
||||
- `src`: Contains package sources (package scripts, extra patches, configuration files etc.)
|
||||
- `dist`: Contains the compiled (built) packages.
|
||||
- `sign-dist.sh`: An extra shell script that you can find in the official pools. It is just a
|
||||
small script that is used to sign all the packages in the `dist` directory if they are built
|
||||
- `dist`: Contains the compiled (built) packages.
|
||||
- `sign-dist.sh`: An extra shell script that you can find in the official pools. It is just a
|
||||
small script that is used to sign all the packages in the `dist` directory if they are built
|
||||
without the signatures.
|
||||
|
||||
# Using different pools
|
||||
MatterLinux releases offer 2 different pools, `base` and `desktop`. There are also development/testing
|
||||
`base` and `desktop` pools (named "next"). URLs for these pools and the mirrors can be found at the [mirrors page](/wiki/mirrors).
|
||||
MatterLinux releases offer 2 different pools, `base` and `desktop`. There are also development/testing
|
||||
`base` and `desktop` pools (named "next"). URLs for these pools and the mirrors can be found at the [mirrors page](/wiki/mirrors).
|
||||
|
||||
These pools can provide packages for users, these packages can be managed using the
|
||||
These pools can provide packages for users, these packages can be managed using the
|
||||
[MatterLinux package manager (`matt`)](/wiki/matt).
|
||||
|
||||
### Building an already existing pool
|
||||
To build an already existing pool, such as the `base` or the `desktop` pool, first you will need to
|
||||
### Building an already existing pool
|
||||
To build an already existing pool, such as the `base` or the `desktop` pool, first you will need to
|
||||
download the pool's source. Source for the `base`, `desktop` and `server` pool can be found on [MatterLinux Git Server](https://git.matterlinux.xyz/matter).
|
||||
|
||||
After downloading the pool source, you will need to install the `mp-pool` tool, which is the tool
|
||||
After downloading the pool source, you will need to install the `mp-pool` tool, which is the tool
|
||||
used for building MatterLinux pools. To do so please you can simply install the [`mtsc`](https://git.matterlinux.xyz/matter/mtsc)
|
||||
package from the `base` pool.
|
||||
|
||||
@ -137,7 +137,7 @@ Finally to build the pool:
|
||||
$ mp-pool <pool dir>
|
||||
```
|
||||
|
||||
You will mostly likely want to disable package signing though, as you are probably don't have the
|
||||
You will mostly likely want to disable package signing though, as you are probably don't have the
|
||||
PGP keys for the official pools:
|
||||
```
|
||||
$ mp-pool --no-sign <pool dir>
|
||||
@ -147,7 +147,7 @@ $ mp-pool --no-sign <pool dir>
|
||||
Unlike most of the package managers, `matt` does not use HTTP, FTP or RSYNC to communicate with the pools. It has it's own
|
||||
custom protocol named [MPTP](/wiki/libmp). Pools are hosted over this protocol using [pooler](https://git.matterlinux.xyz/matter/pooler).
|
||||
|
||||
To host a pool using `pooler`, download and install the `pooler` by following the instructions on the [README](https://git.matterlinux.xyz/matter/pooler). It's also in the `server` pool so you can install it with `matt` as well.
|
||||
To host a pool using `pooler`, download and install the `pooler` by following the instructions on the [README](https://git.matterlinux.xyz/matter/pooler). It's also in the `server` pool so you can install it with `matt` as well.
|
||||
|
||||
After installing it, you'll need to create/edit the configuration file (`/etc/pooler/config.ini`).
|
||||
Here is an example configuration file:
|
||||
@ -171,9 +171,9 @@ $ pooler /etc/pooler/config.ini
|
||||
After running this command, pooler should start hosting your pool over MPTP on port 5858. If you experience
|
||||
any issues, you should check the error logs.
|
||||
|
||||
### Creating a new pool
|
||||
If you want to create an unofficial pool, setup the directory structure for the source pool as
|
||||
explained above. Then create a `pool.sh` script, you can copy one from the official pools and
|
||||
### Creating a new pool
|
||||
If you want to create an unofficial pool, setup the directory structure for the source pool as
|
||||
explained above. Then create a `pool.sh` script, you can copy one from the official pools and
|
||||
edit it.
|
||||
|
||||
After adding your packages and building them with `mp-pool`, you can host it using pooler.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user