Installing Yopass on EndeavourOS

Yopass is a self-hosted project for passwords sharing. It allows users to share passwords and secrets in a secure way. This tutorial will guide you through the process of installing Yopass on EndeavourOS latest release.

Prerequisites

Before beginning this guide, you should have the following:

Step 1 - Clone the Repository

To start with, clone the Yopass repository from Github:

git clone https://github.com/jhaals/yopass.git

Step 2 - Create Configuration

Inside the cloned repository, create a new .env file, and add your configurations to it.

cd yopass/
cp .env.dist .env

Open this .env file and set the following configurations:

SERVER_HOST=localhost
SERVER_PORT=1337
GPG_PRIVATE_KEY_PATH=/path/to/private/key.asc
GPG_PUBLIC_KEY_PATH=/path/to/public/key.asc

SERVER_HOST and SERVER_PORT are the hostname and port Yopass should listen to.

GPG_PRIVATE_KEY_PATH and GPG_PUBLIC_KEY_PATH are the paths to your GPG private and public keys. Note that the private key will be used to decrypt secrets, while the public key will be used to encrypt them.

Step 3 - Start the Application

Before starting the application, you need to build its Docker image:

docker build -t yopass .

Now, start the application using Docker Compose:

docker-compose up

If everything is working, you should see something like this:

yopass_1  | {"level":"info","ts":1613029621.6595063,"msg":"Enabled Features: []","caller":"config/config.go:44"}⏎
yopass_1  | {"level":"info","ts":1613029621.6595907,"msg":"Start application ...","caller":"yopass/main.go:67"}⏎
yopass_1  | {"level":"info","ts":1613029621.66103,"msg":"Yopass Version: v4.0.1","caller":"yopass/main.go:69"}
yopass_1  | {"level":"info","ts":1613029621.79191,"msg":"Starting Server listening on tcp://127.0.0.1:1337","caller":"yopass/server.go:68"}⏎

The application should now be accessible at http://localhost:1337.

Congratulations! You have successfully installed Yopass on EndeavourOS.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!