LaserWeb / LaserWeb4

Collaborative effort on the next version of LaserWeb / CNCWeb
GNU Affero General Public License v3.0
712 stars 192 forks source link

Missing Installation Instructions #648

Closed QuirkyCort closed 2 years ago

QuirkyCort commented 2 years ago

In the installation instructions for Raspberry Pi (https://laserweb.yurl.ch/documentation/installation/36-install-raspberry-pi), under the section "Download and install LaserWeb server", there should be an additional line of...

sudo apt install libusb-1.0-0-dev libudev-dev

... before...

sudo npm install serialport --unsafe-perm --build-from-source

Without it, the build will fail.

So the complete instructions for that section should be...

cd /home/pi
git clone https://github.com/LaserWeb/lw.comm-server.git
cd lw.comm-server
sudo apt install libusb-1.0-0-dev libudev-dev
sudo npm install serialport --unsafe-perm --build-from-source
sudo npm install
cprezzi commented 2 years ago

On which os version did you determine this? In our tests with buster or bullseye we never needed to install libusb or libudev.

Did you also read the "more detailed installation instructions" from @easytarget which are linked at the beginning of the page?

harlock999 commented 2 years ago

Hi, I'm not sure how exact and compatible are the @easytarget instructions compatible with the venerable (old?) LaserWeb dev-es6 branch. The whole point of easytarget fork was to update numerous nodejs packages versions.

Which branch are you trying?

cprezzi commented 2 years ago

@harlock999 As far as I know the installation instructions of @easytarget should work with the actual lw.comm-server version.

Installing LaserWeb4 is only recomended for someone who wants to compile own versions of LW4. For a user installation it's enough to install lw.comm-server (which serves the matching frontend over the embedded webserver).

QuirkyCort commented 2 years ago

Sorry. I completely overlooked the @easytarget instructions, so I'm just following the instructions on https://laserweb.yurl.ch/documentation/installation/36-install-raspberry-pi

I have two installations, one on buster and another on bullseye, both of requires libusb and libudev.

One thing I missed out is that I'm using node 18 rather than node 12. I'm guessing there are no pre-build modules for some dependencies and it needed to be re-build, hence the need for libusb and libudev which isn't required when tested with node 12.

cprezzi commented 2 years ago

Yes, we are based on node 12 as written in the instructions. Was it completely working with node 18 after you installed libusb and libudev?

QuirkyCort commented 2 years ago

Yes. Everything works fine under node 18.

cprezzi commented 2 years ago

Thanks for the info!

cprezzi commented 2 years ago

I have added a hint to the documentation about node 18 and the additional libs.