29 lines
967 B
Markdown
29 lines
967 B
Markdown
|
# supercow
|
||
|
|
|
||
|
|
The [apt repo](https://wiki.debian.org/DebianRepository) server with [super-cow powers](https://unix.stackexchange.com/questions/92185/whats-the-story-behind-super-cow-powers)
|
||
|
|
|
||
|
|
## Features
|
||
|
|
|
||
|
|
- Periodic Auto-Signing
|
||
|
|
- Periodic Auto-Indexing
|
||
|
|
- Hosted through [nginx](https://nginx.org/)
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
### Example
|
||
|
|
|
||
|
|
Run `docker run -ti --name supercow -v ./signing.key:/private/signing.key:ro -v ./pkgs:/private/pkgs:ro -e REPO_DOMAIN=apt.example.com supercow` and enjoy your apt repository.
|
||
|
|
|
||
|
|
### Environment variables
|
||
|
|
|
||
|
|
- `REPO_DOMAIN`: the base domain of your repository, e.g. pkg.maride.cc
|
||
|
|
- `REPO_DESCRIPTION`: repository description, e.g. "maride's finest packages"
|
||
|
|
|
||
|
|
### Volumes & Files
|
||
|
|
|
||
|
|
- `/private/signing.key`: supercow expects an already generated [GPG key](https://gnupg.org/); see `gengpg.sh` for a quickstart
|
||
|
|
- `/private/pkgs`: contains the .deb files to be hosted.
|
||
|
|
|
||
|
|
No file will be modified by supercow; the readonly bind option (`:ro`) may be used.
|
||
|
|
|