Skip to content

Commit c8a15dd

Browse files
committed
add vulsctl
1 parent 25f610e commit c8a15dd

File tree

2 files changed

+63
-0
lines changed

2 files changed

+63
-0
lines changed

docs/install-with-vulsctl.md

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
id: install-with-vulsctl
3+
title: Install wth vulsctl on CentOS
4+
sidebar_label: Easiest way to setup Vuls - Vulsctl
5+
---
6+
7+
## Vulsctl
8+
9+
[Vulsctl](https://github.com/vulsio/vulsctl) was created to ease setup. Each shell script is a wrapper for docker command.
10+
11+
## setup Docker
12+
13+
- Install [Docker](https://docs.docker.com/install/linux/docker-ce/centos/)
14+
- [Manage Docker as a non-root user](https://docs.docker.com/install/linux/linux-postinstall/)
15+
16+
```bash
17+
$ sudo systemctl start docker
18+
```
19+
20+
## Clone Vulsctl
21+
22+
```bash
23+
$ git clone https://github.com/vulsio/vulsctl.git
24+
$ cd vulsctl
25+
```
26+
27+
## Fetch Vulnerability Database
28+
29+
```
30+
$ ./update-all.sh
31+
```
32+
33+
## Scan and Report
34+
35+
Prepare config.toml in the same directory.
36+
37+
```
38+
$ cat $HOME/vulsctl/config.toml
39+
[servers]
40+
[servers.hostos]
41+
host = "52.10.10.10"
42+
port = "22"
43+
user = "centos"
44+
# keypath in the Vuls docker container
45+
keyPath = "/root/.ssh/id_rsa"
46+
```
47+
48+
SSH before scanning to add fingerprint to $HOME/.ssh/known_hosts on the Docker host.
49+
```
50+
$ ssh centos@52.100.100.100 -i ~/.ssh/id_rsa.pem
51+
```
52+
53+
```
54+
$ ./scan.sh
55+
$ ./report.sh
56+
$ ./tui.sh
57+
```
58+
59+
For details, see
60+
- [scan.sh](https://github.com/vulsio/vulsctl/blob/master/scan.sh)
61+
- [report.sh](https://github.com/vulsio/vulsctl/blob/master/report.sh)
62+
- [tui.sh](https://github.com/vulsio/vulsctl/blob/master/tui.sh)

website/sidebars.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
"architecture-deep-scan"
1717
],
1818
"Installation": [
19+
"install-with-vulsctl",
1920
"install-manually-centos",
2021
"install-with-docker",
2122
"install-with-package",

0 commit comments

Comments
 (0)