Initial release: self-hostable APT repository server and CLI
urapt is a self-hostable APT repository server with a companion CLI for pushing and managing Debian .deb packages. Server (urapt-server): - REST API + APT endpoint, SQLite storage (pure-Go modernc driver, no CGO) - .deb files stored content-addressed on disk, reference-counted for dedup - Server-managed RSA-4096 OpenPGP signing key (ProtonMail/go-crypto) - APT indices (Release/InRelease/Packages[.gz/.xz]) generated on demand from the DB, cached in memory, signed with the server key - Full APT model: repositories -> distributions -> components -> architectures - Bearer-token auth for REST; HTTP Basic auth for private-repo APT reads - First registrant becomes admin; repo-scoped permissions (read/write/read-write/admin) plus owner and server-admin roles - Multipart package push with control-field extraction, list/show/delete, pool serving, blob ref-count cleanup - Audit log CLI (urapt): - register/login/logout/whoami, token management - repo/distro/component/arch CRUD, member management - push/pull/ls/show/rm for packages - apt-config helper that emits apt setup commands (key, sources.list, auth.conf for private repos) Packaging & docs: - Dockerfile (multi-stage distroless), docker-compose.yml, sample config - README quick start, architecture overview, config reference, security notes - PLAN.md design blueprint, CHANGELOG.md, GPL-3.0 LICENSE - GitHub Actions CI (test, lint, cross-build for linux/darwin amd64/arm64) - Makefile release target producing static binaries + tarballs + checksums Tests cover the data-access layer, auth/permission checks, APT index generation, .deb parsing, GPG signing, the REST API, and the typed API client. Verified end-to-end on a Raspberry Pi (arm64) pushing and installing a real package.
This commit is contained in:
@@ -0,0 +1,62 @@
|
||||
# Changelog
|
||||
|
||||
All notable changes to urapt will be documented in this file.
|
||||
|
||||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
||||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
## [0.1.0] - 2026-06-28
|
||||
|
||||
First public release. urapt is a self-hostable APT repository server with a
|
||||
companion CLI for pushing and managing Debian `.deb` packages.
|
||||
|
||||
### Added
|
||||
- **Server** (`urapt-server`): REST API + APT endpoint server.
|
||||
- SQLite storage (pure-Go `modernc.org/sqlite`, no CGO) with embedded
|
||||
migrations. Only `.deb` files are stored on disk, content-addressed by
|
||||
SHA-256 and reference-counted for deduplication.
|
||||
- Server-managed RSA-4096 OpenPGP signing key (`ProtonMail/go-crypto`),
|
||||
generated on first run and stored armored in the database.
|
||||
- APT indices (`Release`, `Release.gpg`, `InRelease`, `Packages` with
|
||||
`.gz`/`.xz` compression) generated on demand from the database and cached
|
||||
in memory; never written to disk.
|
||||
- Full APT model: repositories → distributions → components → architectures.
|
||||
- Bearer-token auth for the REST API; HTTP Basic auth (password = API token)
|
||||
for private-repo APT reads. Public repos allow anonymous APT reads.
|
||||
- First registrant becomes admin; repo-scoped permissions
|
||||
(`read`/`write`/`read-write`/`admin`) plus owner and server-admin roles.
|
||||
- Multipart package push with control-field extraction, list/show/delete,
|
||||
pool serving, and blob ref-count cleanup on delete.
|
||||
- Audit log for mutating actions.
|
||||
- **CLI** (`urapt`): companion tool for pushing packages and managing repos.
|
||||
- `register`, `login`, `logout`, `whoami`, `token` (create/list/revoke).
|
||||
- `repo` (create/list/show/update/delete), `member` (add/update/remove/list).
|
||||
- `distro`, `component`, `arch` CRUD.
|
||||
- `push`, `pull`, `ls`, `show`, `rm` for packages.
|
||||
- `apt-config` helper that prints the exact `apt` setup commands (key
|
||||
install, sources.list entry, and auth.conf snippet for private repos).
|
||||
- **Packaging**: `Dockerfile` (multi-stage distroless static build),
|
||||
`docker-compose.yml`, sample `urapt-server.toml.example`.
|
||||
- **Docs**: `README.md` quick start, architecture overview, configuration
|
||||
reference, and security notes; `PLAN.md` full design blueprint.
|
||||
|
||||
### Security
|
||||
- Passwords are bcrypt-hashed (cost 12). API tokens are random 32-byte values
|
||||
stored only as SHA-256 hashes with a short display prefix; revocable.
|
||||
- The OpenPGP private signing key is stored unencrypted in the SQLite
|
||||
database. This is acceptable when you control the database file; for
|
||||
stronger protection, restrict file permissions and back up the DB securely.
|
||||
Per-repo keys and key encryption-at-rest are planned.
|
||||
- For internet-facing deployments, run behind a TLS-terminating reverse proxy
|
||||
(Caddy/nginx). Private-repo credentials must never travel over plain HTTP.
|
||||
|
||||
### Known Limitations
|
||||
- Single server-managed signing key (no per-repo keys yet).
|
||||
- No web UI; all management is via the CLI.
|
||||
- No rate limiting or brute-force protection on login endpoints.
|
||||
- No source packages (`.dsc`/`.orig.tar.*`) or AppStream metadata.
|
||||
|
||||
[Unreleased]: https://github.com/owen/urapt/compare/v0.1.0...HEAD
|
||||
[0.1.0]: https://github.com/owen/urapt/releases/tag/v0.1.0
|
||||
Reference in New Issue
Block a user