Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

How about a WiKi? #18

Open
virgo77 opened this issue Nov 12, 2022 · 9 comments
Open

How about a WiKi? #18

virgo77 opened this issue Nov 12, 2022 · 9 comments

Comments

@virgo77
Copy link

virgo77 commented Nov 12, 2022

Hi,
I'm a new user of this open-source app and I can tell that it's a bit weird to install and use... because there is no real tuto instead the 3 lines on the GitHub page on how to install it with docker. But after that: nothing!

So, I installed it on my local hosted debian VM (as it is asked on the main page) and it now seems to launch on boot. But after that? What should I do? How to connect with the admin account created during install configuration? Are there specific ports to open? (I use UFW to block all incoming traffic but not 80 and 443). But I can't connect however! I tried the app too, but it doesn't connect to my local server because of the user name that must be 6 letters (as 'admin' is only 5...). Great!

So, can someone give more help? Will a tutorial, or maybe a wiki will be available? Because I searched on the web some guide but... nothing! So, ok, it seems to be a great project, but with a good documentation, it will be better for testing purposes!

Thanks a lot

@zigazajc007
Copy link
Member

Hello,

My English is really bad, so I'm not the right person to write the documentation, but I would really appriciate it if someone would help me write it.

Passky Server will by default start on port 8080 (This can be changed in docker-compose.yml file). So you can access Admin Panel on http://serverIP:8080 .Here you can click on "Log In" button and enter your admin creditions.

Passky Server will assign to port 8080, so you can use proxy manager to install SSL certs and manage domains. The easiest proxy manager to use is "Nginx Proxy Manager".

Now you can install Passky Client on your device. You can also self-host Passky Client website.

When you open Passky Client you will see Server field where you can enter url to your Passky Server (in your example: http://serverIP:8080). Note that you can't login with admin creditions here, so you would need to create new account.

@virgo77
Copy link
Author

virgo77 commented Nov 12, 2022

Thanks for your reply.

UFW ports opened : 80 // 443 // 8080
I disabled it for testings

When I'm on Firefox or Chrome, the admin page is reachable. But it is very succinct. There's not a lot of options. Maybe it's normal.

So I tried the app, but still no way. The app says that the server is not reachable. I don't know why. So I can't Sign Up.

I add pics where you can see I'm in Sign Up mode:

Passky - Server Sign Up

Passky - Server Unreachable

@virgo77
Copy link
Author

virgo77 commented Nov 12, 2022

Note that the Passky Server is hosted on Debian 11.5 i686

Here are pics about the Admin Page

Passky - Home Page
Passky - Server Stats
Passky - Server Health
Passky - Settings

@zigazajc007
Copy link
Member

So I tried the app, but still no way. The app says that the server is not reachable. I don't know why. So I can't Sign Up.

This can happen if your application only accept secure connection. So it will deny all insecure (http) connections and only allow secure ones (https).

If you have installed Passky from Microsoft Store this can be a reason. So if you want Passky Client to access your Passky Server thru insecure connection (http) I would suggest you to download it manually.

Windows:

@virgo77
Copy link
Author

virgo77 commented Nov 12, 2022

With the portable app, it's working, thanks

I don't remember how I installed the desktop app but it seems to be the Windows Store one, yep.

I will try to install NGiNX Proxy Manager to test SSL connections. I will give feedback here

Thanks for your very helpful replies :)

About documentation, I don't know where you are from, so maybe I can help as I was stuck: my little experience may help for it

@zigazajc007
Copy link
Member

Awesome, great to hear that.

I'm from Slovenia. I do understand English when I'm reading and also I can type it, but the problem is that my sentences aren't correct (I can't build correct sentences).

@virgo77
Copy link
Author

virgo77 commented Nov 12, 2022

yup! As I am too :)
I write as I can say it in my french language.
I don't know when to do it, but maybe I can give you a little doc on how to install and use Passky.

erm, a little request: will Passky be able to use Folders, like in KeePass/XC?
The import functionality works, but from a CSV file it adds correctly all the passwords but they are totally mixed. So I need to search for them as their names are created as they were inside folders, or subfolders.

For example:
Root: HOME
1rst folder: Hypervisor
Sub-Folder: ESXi
Cred.: root (or admin, etc.)

Like this:
HOME
----Hypervisors
--------ESXi
------------root / password
------------other creds
------------etc.

So actually, from the import, all the credentials are all mixed. Annoying ^^

I think I will pull a new request for this ^^

See you

@zigazajc007
Copy link
Member

Good idea, I have added support for folders to my TODO list: https://github.com/orgs/Rabbit-Company/projects/1

@CMB244
Copy link

CMB244 commented Dec 20, 2022

sorry, this is just for testing purpose

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants