Keep passwords and other sensitive information out of your chat logs and emails.
Note
Development happens on GitLab: https://gitlab.com/onetimesecret/onetimesecret. Open issues and merge requests there. The GitHub repository is a read-only mirror, and the Docker Hub and GHCR images are still built from it.
A one-time secret is a link that can be viewed only once — a single-use URL. When you share sensitive info like a password over email or chat, copies linger in many places. Onetime links self-destruct after viewing, so only the intended recipient ever sees the contents.
Try it live at OnetimeSecret.com →
# 1. Start Redis on a private Docker network, password-protected and with
# no host port — the app reaches it by container name
docker network create onetime
openssl rand -hex 32 > .ots_redis_password && chmod 600 .ots_redis_password
docker run -d --name onetime-redis --network onetime redis:trixie \
redis-server --requirepass "$(cat .ots_redis_password)"
# 2. Generate and store a persistent secret key — back this up safely
openssl rand -hex 32 > .ots_secret && chmod 600 .ots_secret
# 3. Run Onetime Secret (set SSL=true for production)
docker run -p 3000:3000 -d \
--name onetimesecret \
--network onetime \
-e REDIS_URL="redis://:$(cat .ots_redis_password)@onetime-redis:6379/0" \
-e SECRET="$(cat .ots_secret)" \
-e HOST=localhost:3000 \
-e SSL=false \
onetimesecret/onetimesecret:v0.26.14Open http://localhost:3000, then create an admin ("colonel") account — it prints a generated password and is verified immediately:
docker exec onetimesecret bin/ots customers create [email protected] --role colonelImportant
Losing your SECRET key is not recoverable. It makes existing
secrets unreadable among other things, so back it up.
- Self-hosting — reverse proxy, full authentication (PostgreSQL + RabbitMQ, MFA, WebAuthn), and production hardening: Self-Hosting Guide
- Docker Compose — simple and full stacks: docker/README.md
- Configuration — .env.reference and config defaults
- Contributing — from clone to a green test suite in two commands, plus test accounts & API tokens: CONTRIBUTING.md
- Get help — Documentation · Report an issue · Support
- Project — Latest Release · Docker Hub · Build Status
- Policies — Security · Code of Conduct
- See also — Similar services & alternatives
Onetime Secret was developed with help from AI tools for architecture design, code generation, and documentation. As project maintainers, we remain responsible for all design decisions and the final code, and believe in being transparent about the tools involved.
MIT — see LICENSE.txt.