vieter/docs/content/usage/repository.md

39 lines
1.5 KiB
Markdown

# Pacman repository
The part of Vieter that users will interact with the most is the Pacman
repository aka `vieter server`.
## Design overview
A Vieter repository server has support for multiple repositories, with each
repository containing packages for multiple architectures.
If you wish to use these repositories on your system, add the following to
`/etc/pacman.conf` for each repository you wish to use:
```
[repo-name]
Server = https://example.com/$repo/$arch
SigLevel = Optional
```
Here, `$repo` & `$arch` are not variables you have to fill in yourself. Rather,
Pacman will substitute these when reading the config file. `$repo` is replaced
by the name between the square brackets (in this case `repo-name`), & `$arch`
is replaced by your system's architecture, e.g. `x86_64`. Of course, you can
also fill in these values manually yourself, e.g. if you wish to use a
different name inside the square brackets.
Important to note is that, when two repositories contain a package with the
same name, Pacman will choose the one from the repository that's highest up in
the `pacman.conf` file. Therefore, if you know your repository has packages
with the same name as ones from the official repositories, it might be better
to place the repository below the official repositories to avoid overwriting
official packages.
## Publishing packages
Packages can be easily published using a single HTTP POST request. Check out
the [HTTP API docs](https://rustybever.be/docs/vieter/api/) for more info on
these routes, including example cURL commands.