Update both README and LICENSE (still ISC)
This commit is contained in:
parent
5354c950fa
commit
a1edace600
4
LICENSE
4
LICENSE
@ -1,4 +1,6 @@
|
|||||||
Copyright 2022 James Eversole (james@eversole.co)
|
ISC LICENSE
|
||||||
|
|
||||||
|
Copyright James Eversole (james@eversole.co)
|
||||||
|
|
||||||
Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
|
Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
|
||||||
|
|
||||||
|
51
README
51
README
@ -1,51 +0,0 @@
|
|||||||
purr
|
|
||||||
-----
|
|
||||||
|
|
||||||
https://purr.eversole.co
|
|
||||||
a work-in-progress web application offering customizable password generation
|
|
||||||
and time-limited sharing of secrets.
|
|
||||||
|
|
||||||
TECH STACK
|
|
||||||
|
|
||||||
- Haskell and Scotty backend
|
|
||||||
- HTMX frontend
|
|
||||||
- SQLite database
|
|
||||||
|
|
||||||
GOALS
|
|
||||||
|
|
||||||
- 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.
|
|
||||||
|
|
||||||
- Provide a minimal and clean interface for generating and sharing passwords.
|
|
||||||
|
|
||||||
- Maintain a clean and organized codebase that can be extended to include more
|
|
||||||
utilities than originally anticipated.
|
|
||||||
|
|
||||||
- Be really cute compared to the competition.
|
|
||||||
|
|
||||||
WHY TRUST YOU?
|
|
||||||
|
|
||||||
You shouldn't. This is free and open-source software which you can run on your
|
|
||||||
own hardware.
|
|
||||||
|
|
||||||
DEPLOYMENT
|
|
||||||
|
|
||||||
Only Nix build instructions targeting containers are provided below,
|
|
||||||
but this project can be built and run without containers or Nix using Cabal.
|
|
||||||
|
|
||||||
- Clone this repository
|
|
||||||
- Build the container image (with flakes enabled): `nix build .#purr-container`
|
|
||||||
- Load the container image
|
|
||||||
- podman load -i result
|
|
||||||
- Use the provided docker stack example to deploy the container if desired
|
|
||||||
- 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. I hold
|
|
||||||
no liability for any defects and no guarantees are made to its usability.
|
|
||||||
|
|
||||||
Copyright James Eversole (james@eversole.co)
|
|
67
README.md
Normal file
67
README.md
Normal file
@ -0,0 +1,67 @@
|
|||||||
|
# purr
|
||||||
|
|
||||||
|
[purr.eversole.co](https://purr.eversole.co)
|
||||||
|
|
||||||
|
a simple web application offering customizable password generation
|
||||||
|
and time-limited sharing of secrets.
|
||||||
|
|
||||||
|
## TECH STACK
|
||||||
|
|
||||||
|
- [Haskell](https://www.haskell.org)
|
||||||
|
- [Scotty](https://hackage.haskell.org/package/scotty)
|
||||||
|
- [HTMX](https://htmx.org)
|
||||||
|
- [SQLite](https://www.sqlite.org)
|
||||||
|
|
||||||
|
## GOALS
|
||||||
|
|
||||||
|
- 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 targeting containers are provided below,
|
||||||
|
but this project can be built and run without containers or Nix by using Cabal.
|
||||||
|
|
||||||
|
1) Clone this repository
|
||||||
|
2) Build the container image (with flakes enabled): `nix build .#purr-container`
|
||||||
|
3) Load the container image
|
||||||
|
- podman load -i result
|
||||||
|
4) 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}";
|
||||||
|
};
|
||||||
|
};
|
||||||
|
```
|
||||||
|
5) Docker Stack
|
||||||
|
1) Set environment variables in docker-stack.yml or mount a .env file.
|
||||||
|
2) `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.
|
||||||
|
|
||||||
|
Copyright James Eversole (james@eversole.co)
|
Loading…
x
Reference in New Issue
Block a user