IUS/once
IUS/once
8
0
Fork 0
Code Issues 7 Pull requests 2 Projects 1 Releases 6 Activity Actions
re-implementation of https://once.schlittermann.de/
323 commits 6 branches 77 tags 5.1 MiB
  • Go 82.4%
  • HTML 11.9%
  • Roff 5.4%
  • Makefile 0.3%
Find a file
Exact
Heiko Schlittermann (HS12-RIPE) 0c3dab8bf3
All checks were successful
nagonag (Push) / nagonag (push) Successful in 3m40s
Details
fix: align default config paths with actual installation layout ai:claude-sonnet-4-5 
The code defaults contained /etc/once/v2/ and /var/lib/once/v2/ paths
that were never used in production (the systemd unit always passes
-config /etc/once/once.conf explicitly) but would silently fail if
the binary was invoked without -config.

The drift was present since the initial v2 commit (7b669c0): opt.go
got a /v2/ suffix while the service unit kept the old path. Align all
defaults with what is actually installed on disk.
2026-05-28 12:54:53 +02:00
.forgejo/workflows Add nagonag workflows 2026-05-24 13:34:59 +02:00
.pi fix: improve config validation and file count check (issues #62, #63) ai:claude-sonnet-4-5 2026-05-24 21:01:40 +02:00
assets Add README hero and avatar assets 2026-05-24 14:22:55 +02:00
v2 fix: align default config paths with actual installation layout ai:claude-sonnet-4-5 2026-05-28 12:54:53 +02:00
.gitignore Ignore vim swap files 2021-11-17 17:53:36 +01:00
.gogogo.conf go: use all lower for module name 2025-09-10 12:57:55 +02:00
.golangci.yaml go: linter wsl 2024-01-13 22:20:08 +01:00
go.sum Add README hero and avatar assets 2026-05-24 14:22:55 +02:00
LICENSE.txt Squashed commit of the following: 2025-09-10 12:20:10 +02:00
minor_patch_updates.json deps(master): update minor/patch dependencies 2026-05-24 15:38:00 +00:00
README.md Use v2 hero in top-level README 2026-05-24 15:26:51 +02:00
updates.json deps(master): update minor/patch dependencies 2026-05-24 15:38:00 +00:00
vuln_ids.txt deps(master): update minor/patch dependencies 2026-05-24 15:38:00 +00:00

README.md

Once hero

Once - download it once

Forwarding sensitive information (like account credentials) to a customer isn't always easy.

  1. Sharing the data via mail or chat as cleartext isn't secure.
  2. Sharing the data symmetrically encrypted (e.g. encrypted ZIP) needs the exchange of the shared secret in a secure manner.

In above scenarios we can't be even sure that the information wasn't accessed by an eavesdropper.

To be honest, the only perfect solution is sharing the data asymmetrically encrypted (GPG), but this is beyond the capabilities of most recipients.

How does Once work?

Via Once we share a (hard-to-guess) link with the recipient. The recipient can access that link exactly once (hence the name of the project). After accessing the link, the stored document gets deleted.

In case an eavesdropper was faster accessing the link, the real recipient can't use the link anymore and we can tell that the shared information should be considered as leaked.

Build and Install

For information about how to build and install it from the sources, please checkout the README document about the once-server.

A packaged version of the once-server is available for Debian GNU/Linux from our private Debian "sid" Repo:

wget -O - https://schlittermann.de/keys/gpg/apt.schlittermann.de/2F48BFA2AEB951E9370D3599F2E97DC20A805F65.asc | apt-keys add
echo deb http://apt.schlittermann.de/ sid main >> /etc/apt/sources.list.d/schlittermann.list
apt update
apt install once-server/sid

There are more instructions on how to proceed after install.