Getting started

Onetime Secret lets you share sensitive information through a link. The recipient reveals the secret once, then it is deleted. This documentation covers creating, sharing and managing those self-destructing messages — on the hosted service at onetimesecret.com, on an instance you run yourself, or through the API.

Ready to try it? Send your first secret without creating an account.

Continue with your task

Choose a guide for what you want to do next.

Share secrets

• Send your first secret — create a link, send it, and check its status
• Sharing secrets — how one-time secret sharing works
• Security best practices — keep your shared secrets safe
• Custom domains — use your own domain for secret sharing, starting with Setting up a custom domain
• Glossary — definitions of receipt, passphrase, organization, and other product terms

Evaluate Onetime Secret

• Why use secret links — the problem one-time links solve
• Use cases — examples of sharing passwords and other sensitive information
• Hosted or self-hosted? — compare the hosted service with running your own instance
• Where your data lives — data locality and the available regions
• Compare plans — feature comparison across plans

Integrate with your code

• REST API — programmatic access, and the full API reference (v1, v2, v3)
• Client libraries — community SDKs and integrations

Run your own instance

• Self-hosting overview — what running an instance involves, and where to start
• Install with Docker — or install on Linux from a checkout
• Configuration — settings reference

Questions?

Contact us directly.