gaschz/qubes-pass
1
0
Fork 0
mirror of https://github.com/gaschz/qubes-pass.git synced 2025-03-01 14:22:31 +01:00
Code Issues Packages Projects Releases Wiki Activity

The docs were totally wrong, and this fixes #1

Browse Source 
Thanks to @zeustrismegistus for helping me fix this bug.
This commit is contained in:
Rudd-O 2017-05-08 20:22:51 +00:00 committed by GitHub
parent 42789f3e90
commit 75869e7161
1 changed files with 17 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
README.md
View File

@ -66,15 +66,17 @@ Run `qvm-pass -?` on a terminal to get usage information.
There are three components for this software: There are three components for this software:
* The client `qvm-pass-client` you install in the VMs (or their templates) * The client `qubes-pass` you install in the VMs (or their templates)
where you want to manage your passwords. where you want to manage your passwords.
* The service `qvm-pass-service` you install in the VMs (or their templates) * The service `qubes-pass-service` you install in the VMs (or their templates)
where you want to store your passwords. where you want to store your passwords.
* The policy `qvm-pass-dom0` is the dom0 side of things, necessary to * The policy `qubes-pass-dom0` is the dom0 side of things, necessary to
enable the services and control access from the clients to the service. enable the services and control access from the clients to the service.
First, build the software, After cloning this repository on a suitable VM, Here's how you install `qubes-pass` on Fedora VMs (*see below for other OSes*):
run the command:
After cloning this repository on a suitable VM, and installing the
`rpm-build` package onto that VM, run the command:
``` ```
make rpm make rpm
@ -82,30 +84,31 @@ make rpm
This will generate three installable packages on the local directory: This will generate three installable packages on the local directory:
* `qvm-pass-client-<version>.noarch.rpm` * `qubes-pass-<version>.noarch.rpm`
* `qvm-pass-service-<version>.noarch.rpm` * `qubes-pass-service-<version>.noarch.rpm`
* `qvm-pass-dom0-<version>.noarch.rpm` * `qubes-pass-dom0-<version>.noarch.rpm`
Copy the `qvm-pass-client-<version>.noarch.rpm` file to the template VM Copy the `qubes-pass-<version>.noarch.rpm` file to the template VM
or standalone VM where you plan to manage passwords. Install the RPM with or standalone VM where you plan to manage passwords. Install the RPM with
`dnf install <name of the RPM>`. At this point, this VM, as well as `dnf install <name of the RPM>`. At this point, this VM, as well as
any VMs using this as a template, have gained the ability to list any VMs using this as a template, have gained the ability to list
and store passwords stored in other VMs. and store passwords stored in other VMs.
Now copy the `qvm-pass-service-<version>.noarch.rpm` file to the template Now copy the `qubes-pass-service-<version>.noarch.rpm` file to the template
VM or standalone VM where you plan to store passwords. Install the RPM with VM or standalone VM where you plan to store passwords. Install the RPM with
`dnf install <name of the RPM>`. At this point, this VM, as well as `dnf install <name of the RPM>`. At this point, this VM, as well as
any VMs using this as a template, have gained the ability to securely store any VMs using this as a template, have gained the ability to securely store
passwords in `/home/user/.password-store`. passwords in `/home/user/.password-store`.
Now copy the `qvm-pass-policy-dom0-<version>.noarch.rpm` file to Now copy the `qubes-pass-policy-dom0-<version>.noarch.rpm` file to
your dom0. At this point, the default policy (`ask`) is active on your dom0. At this point, the default policy (`ask`) is active on
your Qubes OS system, and you can begin using the client. your Qubes OS system, and you can begin using the client.
Those clever among you will have discovered that there is a `Makefile` Those clever among you will have discovered that there is a `Makefile`
included, and that you can use the `Makefile` to install the software on included, and that you can use the `Makefile` to install the software
other non-RPM templates. I welcome pull requests to add support for on other non-RPM, non-Fedora templates. I welcome pull requests to add
other distro packages and Qubes OS templates. support for other distro packages and Qubes OS templates. Thanks in
advance for your help.
## Troubleshooting and debugging ## Troubleshooting and debugging