Transition in progress
----------------------

The latest version of greenbone-security-assistant is not yet ready for
Debian and the current version will not work with the updated gvm
packages. Sorry for this but greenbone-security-assistant uses tons of
nodejs modules and their packaging in Debian is difficult.

We have a source package that you can build but this source package can't
be uploaded to Debian because it downloads the missing modules during the
build (which is against the Debian policy).

$ sudo apt install git-buildpackage devscripts
$ git clone https://salsa.debian.org/pkg-security-team/greenbone-security-assistant.git
$ cd greenbone-security-assistant
$ sudo mk-build-deps -i debian/control
$ gbp buildpackage
$ sudo debi


About GVM installation and setup
--------------------------------

On a fresh install you need to install the package gvm.
Then
    - Run 'sudo gvm-setup'
    Note the password displayed at the end of the setup. You
    will need it to connect you to the Web UI GSA (greenbone-security-assistant)
    Or change the admin password with
    'sudo runuser -u _gvm -- gvmd --user=admin --new-password=yourpassword'

    - Run 'sudo gvm-check-setup'
    It will start the all the required services.

If you had the obsolete openvas package installed, please read the
MIGRATION-FROM-9-TO-11 file before trying to run setup or another
command.


How to run gvm commands
-----------------------

Since gvm 11, we use a special user _gvm.

You will need to use this user to run the GVM commands, like

sudo runuser -u _gvm -- gvmd --get-scanners
sudo runuser -u _gvm -- gvmd ...

sudo runuser -u _gvm -- greenbone-nvt-sync
sudo runuser -u _gvm -- greenbone-certdata-sync
sudo runuser -u _gvm -- greenbone-scapdata-sync

NOTE: if you run commands only with sudo (or as root user), created or
updated files may by owned by root instead of _gvm user and your
installation will not work correctly.

You can stop the GVM services with gvm-stop.
You can start the GVM services with gvm-start.
