# Onetime Secret

> Share passwords as private links that work only once.

- Page: https://cgt.octabyte.io/templates/onetimesecret/
- Category: Security & sign-in
- Replaces: Privnote
- Ease of use: Easy. Anyone with the address can share a secret straight away; accounts need email set up first.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: MIT
- Good for: Teams handing out passwords and logins to staff or clients by link
- Official website: https://onetimesecret.com
- Documentation: https://docs.onetimesecret.com/en/self-hosting/
- Source code: https://github.com/onetimesecret/onetimesecret
- Last updated: 2026-11-17

## What is Onetime Secret?

Self-hosted Onetime Secret: share passwords and private notes as links that open once, then self-destruct, so secrets stay out of chat and email.

Self-hosted Onetime Secret is a free, open-source way to share a password or private note as a link that works only once, on your own server instead of a hosted service such as Privnote or onetimesecret.com. You paste the secret, add a passphrase if you like and choose how long the link lasts. The person you send it to opens the link, clicks to reveal it, and the secret is deleted, so it never sits in an email thread or chat history.

A bakery owner, for example, can send a new staff member the till login as a one-time link with a three-day limit, phone them the passphrase, and check on the private receipt that it was opened. If the link was sent to the wrong person, the owner can burn it from the receipt before anyone reads it.

Onetime Secret runs in any web browser, including on phones; there are no separate apps. It can also generate strong passwords, and your own scripts can create secrets through its API. Secrets are encrypted on your server and deleted once read or expired.

Cloudgate installs Onetime Secret on a server Cloudgate provides or one you connect, with the small database it needs, and gives it a secure web address. You can share your first secret as soon as it opens.

## What you can do with Onetime Secret

- **Links that work once**: Paste a password or note and get a link that shows it one time, then deletes it.
- **Choose when it expires**: Pick a lifetime from one minute to seven days; an unread secret is deleted when time runs out.
- **Add a passphrase**: Ask for a second word before the secret opens, and send that word another way, such as by phone.
- **Check the receipt**: A private receipt link shows whether your secret is still new, was previewed or has been revealed.
- **Take it back**: Burn an unread secret from its receipt, so the link stops working for good.
- **Make a strong password**: Generate a random password and share it as a one-time link in the same step.
- **No account for your recipient**: The person you send it to just opens the link and clicks to reveal; they don't sign up.
- **Use it from your own tools**: Create, read and burn secrets from scripts through the same API as onetimesecret.com.

## Replaces Privnote

Onetime Secret does the same job as Privnote. Here is what changes when you switch.

### What you gain

- Your secrets are stored on your own server and shared under your own web address
- Add a passphrase and choose a lifetime from one minute to seven days
- A private receipt shows whether each secret was previewed or revealed, and lets you burn it first
- Free and open source under the MIT licence, with an API for your own scripts

### What is different

- Secrets are encrypted on your server, not in the sender's browser
- It shares text only, not files
- Anyone who can reach your address can create secrets, limited per visitor
- Links you already sent from Privnote stay there; let them be read or expire

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=onetimesecret

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. Onetime Secret itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up Onetime Secret.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is Onetime Secret free?

Yes, Onetime Secret is free and open source under the MIT licence, with no paid self-hosted edition. You pay only for your server, with no limit on how many secrets you share.

### Is Onetime Secret a good alternative to Privnote?

Yes. Onetime Secret is a good alternative to Privnote if you want self-destructing notes on your own server and web address. Like Privnote, Onetime Secret sends a password or note as a link that opens once; it adds a passphrase, a lifetime you choose and a receipt that shows whether the secret was read. It shares text only, and the hosted onetimesecret.com runs the same app.

### Does the person I send a secret to need a Onetime Secret account?

No. They open the Onetime Secret link and click to reveal the secret. If you added a passphrase, they also type that in.

### Will a chat or email link preview use up the secret?

No. Opening a Onetime Secret link only shows a "Click to reveal" page, so a preview that just loads it does not use up the secret. Your receipt marks the link as previewed, and the secret is used only when someone reveals it.

### Is Onetime Secret end-to-end encrypted?

No, Onetime Secret encrypts each secret on your server with your server's own key and deletes it once it is read or expires. The passphrase controls who can open it. If you need encryption in the sender's browser, tools such as PrivateBin or Yopass work that way.

### How do I sign in to Onetime Secret the first time?

You don't have to; anyone with your Onetime Secret address can share a secret right away without signing in. Sign-up asks new users to confirm their email, so connect an email service first, and the admin account is created with one command on the server, which prints its password once.

### What server size do I need for Onetime Secret?

A small server is enough, because Onetime Secret is one light app plus a small database. The project recommends 2 GB of memory, and Cloudgate sets everything up for you.

### Do I need technical skills to run Onetime Secret?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up Onetime Secret and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for Onetime Secret?

No. When you deploy Onetime Secret, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.

### Can I move my data from Privnote to Onetime Secret?

Most people export from Privnote and import into Onetime Secret. The official guides at docs.onetimesecret.com walk through it.
