Simple & Secure Password Sharing with Auto-Expiration of Shared Items

---

Password Pusher is an opensource application to communicate passwords over the web. Links to passwords expire after a certain number of views and/or time has passed.

Hosted at pwpush.com but you can also easily run your own private instance with just a few steps.

• Easy-to-install: Host your own via Docker, a cloud service or just use pwpush.com
• Opensource: No blackbox code. Only trusted, tested and reviewed opensource code.
• Audit logging: Track and control what you've shared and see who has viewed it.
• Encrypted storage: All sensitive data is stored encrypted and is deleted once expired.
• Host your own: Database backed or ephemeral, easily run your own instance isolated from the world.
• JSON API: Raw JSON API available for 3rd party tools or command line via curl or wget.
• Command line interface: Automate your password distribution with CLI tools or custom scripts.
• Internationalized: 10 language translations are bundled in. Easily selectable via UI or URL
• Unbranded delivery page: No logos, superfluous text or unrelated links to confuse end users.
• Customizable: Change text and default options via environment variables.
• Light & dark themes: Via CSS @media integration, the site theme follows your local preferences
• 10 Years Old: Password Pusher has securely delivered millions and millions of passwords in it's 10 year history.
• Honest Software: Opensource written and maintained by me with the help of some great contributors. No organizations, corporations or evil agendas.

Follow Password Pusher on Twitter, Gettr or on Facebook for the latest news, updates and changes.

---

How to Use

You can access Password Pusher at pwpush.com or alternatively use one of the tools below.

To run your own instance, see Run Your Own Instance in the next section.

Command Line Utilities

• pgarm/pwposh: a PowerShell module available in the PowerShell Gallery

• kprocyszyn/Get-PasswordLink.ps1: a PowerShell based CLI

• lnfnunes/pwpush-cli: a Node.js based CLI

• abkierstein/pwpush: a Python based CLI

Libraries & APIs

• oyale/PwPush-PHP: a PHP library wrapper to easily push passwords to any Password Pusher instance

Android Apps

• Pushie by chesire

Application Integrations

• Slack: How to Add a Custom Slash Command

• Alfred Workflow for Mac users

API

• JSON API

💾 Run Your Own Instance

Note: Password Pusher can be largely configured by environment variables so after you pick your deployment method below, make sure to read the configuration page. Take particular attention in setting your own custom encryption key which isn't required but provides the best security for your instance.

On Docker

Docker images of Password Pusher are available on Docker hub.

➜ ephemeral

docker run -d -p "5100:5100" pglombardo/pwpush-ephemeral:release

Learn more

➜ using an External Postgres Database

docker run -d -p "5100:5100" pglombardo/pwpush-postgres:release

Learn more

➜ using an External MariaDB (MySQL) Database

docker run -d -p "5100:5100" pglombardo/pwpush-mysql:release

Learn more

Note: The latest Docker container tag builds nightly off of the latest code changes and can occasionally be unstable. Always use the 'release' or version'd tags if you prefer more stability in releases.

With Docker Compose

Included in this repository are Docker Compose YAML files which can be used by simply running:

docker-compose up -d
docker-compose down

• Docker Compose for a MariaDB (MySQL) backed instance.
• Docker Compose for a Postgres backed instance.

On Kubernetes

Instructions and explanation of a Kubernetes setup can be found here.

On Microsoft Azure

There used to be a 3rd party blog post with instructions but it's been deleted. If anyone has instructions they would like to contribute, it would be greatly appreciated.

See issue #277

On OpenShift

See our OpenShift documentation.

On Heroku

One click deploy to Heroku Cloud without having to set up servers.

This option will deploy a production Password Pusher instance backed by a postgres database to Heroku. As is monthly cost: $0.

From Source

Make sure you have git and Ruby installed and then:

git clone [email protected]:pglombardo/PasswordPusher.git
cd PasswordPusher
gem install bundler
bundle install --without development production test --deployment
bundle exec rake assets:precompile
RAILS_ENV=private bundle exec rake db:setup
foreman start internalweb

Then view the site @ http://localhost:5100/.

📼 Credits

Translators

Thanks to our great translators. We'll fill this area out more as we add more languages.

• Łukasz (Github) for Polish
• Thomas @ confluencepoint (Github | Twitter) for German

Also thanks to translation.io for their great service in managing translations. It's also generously free for opensource projects.

Containers

Thanks to:

• @fiskhest the Kubernetes installation instructions and manifests.

• @sfarosu for contributing the Docker, Kubernetes & OpenShift container support.

Other

Thanks to:

• @iandunn for better password form security.

• Kasper 'kapöw' Grubbe for the JSON POST fix.

• JarvisAndPi for the favicon design

...and many more. See the Contributors page for more details.