Provide a minimal and clean interface for generating and sharing passwords.
Generate sufficiently memorable but secure passwords for use with accounts that don't offer better authentication methods.
Share text secrets with others without disclosing the secret in the message itself.
Maintain a clean and organized codebase that can be extended to include more utilities than originally anticipated.

WHY TRUST PURR.EVERSOLE.CO?

You shouldn't. This is free and open-source software which you can run on your own hardware!

DEPLOYMENT

Only Nix build instructions are provided below.

No Containers

Clone this repository
Build the application (with flakes enabled): nix build '.#'
Set the environment variables
- File: cp examples/.env.example ./.env; $EDITOR ./.env
- If you want to set them in a different way, you already know how.
Run the application: ./result/bin/Purr

Containers

Clone this repository
Build the container image (with flakes enabled): nix build .#purr-container
Load the container image: podman load -i result
Pick option 5, 6, or use your favorite process to manage containers and ENV
NixOS configuration:

virtualisation.oci-containers.containers.purr = {
  image = "purr";
  ports = [ "${PURR_EXTERNAL_PORT}:3000" ];
  volumes = [
    "/PATH/TO/PURR/data:/app/data"
  ];
  environment = { 
    PURRNOFILE = "true";
    ENVIRONMENT = "production";
    APPLICATIONHOST = "localhost";
    APPLICATIONPORT = "3000";
    DATADIR = "/app/";
    LINKLENGTH = "24";
    ADMINEMAIL = "${YOUR_EMAIL}";
  };
};

Docker Stack
1. Copy the docker-stack.yml example and edit as needed.
  1. cp examples/docker-stack.yml ./; $EDITOR ./docker-stack.yml
2. Set environment variables:
  - cp examples/.env.example ./.env; $EDITOR ./.env
  - Or set them in the docker-stack.yml environment declaration.
3. Deploy: docker stack deploy -c docker-stack.yml purr

DEVELOPMENT & SUPPORT

Per the permissive ISC license, you are free to do what you wish with this software. No guarantees are made to its usability, security, or functionality.