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

Installation Instructions - I must be misunderstanding your instructions #89

Open
bmullan opened this issue Jan 19, 2023 · 1 comment
Open

Comments

@bmullan
Copy link

bmullan commented Jan 19, 2023

Maybe I am just misunderstanding your instructions since you say it works for you.

I downloaded the v5.1 .DEB file (amd64) from your Github.

Used GDEBI to install the .DEB file

$ gdebi *.deb

(it seems to install fine)

Then I continue with your instructions


$ sudo cp /etc/wirespider/wg0-example /etc/wirespider/wg0
# edit the file to fit your setup (use correct device name)
# sudo nano /etc/wirespider/wg0
# enable auto start and start the tunnel
# use the same device name
$ sudo systemctl enable --now [email protected]


then... again the 1st command in the "How to run the server" section...

Question: does your .DEB install sqlite? Or is it a Prerequisite that it needs to be install prior to all this? Your README doesn't say if sqlite needs to be preinstalled or not. I found I had to install sqlite myself but then still get the following failure:

$ sudo wirespider database migrate -d sqlite:/var/lib/wirespider/config.sqlite
Error: error returned from database: (code: 14) unable to open database file

When you try this are you doing it in a fresh VM or server? re no artifacts installed previously?

Lets assume someone just wants to install wirespider using the .DEB file !

Could you just show a Bash script with ONLY the necessary commands to install the Client & the Server?

Maybe split the instructions into 2 sections:

  • **installing from Source/Manually
  • installing from the .DEB file**

Instead of intermixing the instructions in your Github README.md file. Right now... it first mentions using wget to get the latest but it doesn't mention whether the commands also install the latest.

Next, the instructions talk about "Manual Installation"... just being a (tech doc critic here - I suffer too trying to be clear)... but
is that actually to be done after the section above about using wget ? Can't leave that to the new user/reader.

Then the Sections about "Running Wirespider" and "How to Run the Server".

Running WireSpider...
How would an end-user know what the "same device" means...? save device as what?

use the same device name

$ sudo systemctl enable --now [email protected]

Brian

@returntoreality
Copy link
Contributor

I think the issue is that the debian package does not create the user and thus does not create the directory /var/lib/wirespider. Can you try running: sudo adduser --system --group --home /var/lib/wirespider wirespider? Make sure the directory /var/lib/wirespider is owned by wirespider.
I think you might hit another issue, since the database will then be created as the current user, but it should be created as the user wirespider. Otherwise you will hit an permission problem when trying to start the server. I've updated the README to include "sudo -u wirespider" before the database management commands (this probably requires you to run them as root unless you changed your sudoers file).

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

2 participants