Skip to content

About

Read-only mirror of https://gitlab.com/onetimesecret/onetimesecret (development, issues and merge requests are there). Keep passwords and other sensitive information out of your chat logs and inboxes.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3.0k stars

Watchers

40 watching

Forks

Latest commit

 

History

22,416 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Onetime Secret — Secure One-Time Message Sharing

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 →

Quick Start (Docker)

# 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.14

Open 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 colonel

Important

Losing your SECRET key is not recoverable. It makes existing secrets unreadable among other things, so back it up.

Going further

Community & Support

AI Development Assistance

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.

License

MIT — see LICENSE.txt.

About

Read-only mirror of https://gitlab.com/onetimesecret/onetimesecret (development, issues and merge requests are there). Keep passwords and other sensitive information out of your chat logs and inboxes.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3.0k stars

Watchers

40 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages