Skip to content

Commit c421251

Browse files
authored
Docs | Update CLI reference (hestiacp#3348)
* Update CLI reference * Update notes * Update CLI Reference
1 parent 785d4ab commit c421251

File tree

6 files changed

+57
-33
lines changed

6 files changed

+57
-33
lines changed

bin/v-add-user-composer

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
# example: v-add-user-composer user [version]
66
#
77
# This function adds support for composer (php dependency manager)
8-
# Homepage: https://getcomposer.org/
8+
# Homepage: <https://getcomposer.org/>
99

1010
#----------------------------------------------------------#
1111
# Variables & Functions #

bin/v-add-web-domain-stats

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
# example: v-add-web-domain-stats admin example.com awstats
66
#
77
# This function is used for enabling log analyser system to a domain. For viewing
8-
# the domain statistics use http://domain.tld/vstats/ link. Access this page
8+
# the domain statistics use <http://domain.tld/vstats/> link. Access this page
99
# is not protected by default. If you want to secure it with passwords you
1010
# should use v-add-web-domain_stat_auth script.
1111

bin/v-change-user-ns

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
#!/bin/bash
2-
# info: change user nameservers
2+
# info: change user name servers
33
# options: USER NS1 NS2 [NS3] [NS4] [NS5] [NS6] [NS7] [NS8]
44
#
55
# example: v-change-user-ns ns1.domain.tld ns2.domain.tld
66
#
7-
# This function for changing default nameservers for specific user.
7+
# This function for changing default name servers for specific user.
88

99
#----------------------------------------------------------#
1010
# Variables & Functions #

bin/v-import-cpanel

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
#
77
# Based on sk-import-cpanel-backup-to-vestacp
88
# Credits: Maks Usmanov (skamasle) and contributors:
9-
# Thanks to https://github.com/Skamasle/sk-import-cpanel-backup-to-vestacp/graphs/contributors
9+
# Thanks to <https://github.com/Skamasle/sk-import-cpanel-backup-to-vestacp/graphs/contributors>
1010

1111
# Known issue
1212
# - Importing certificates fails at the moment. Due to format changes of CPanel side

bin/v-search-command

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
# This function searches for available Hestia Control Panel commands
88
# and returns results based on the specified criteria.
99
# Originally developed for VestaCP by Federico Krum
10-
# https://github.com/FastDigitalOceanDroplets/VestaCP/blob/master/files/v-search-command
10+
# <https://github.com/FastDigitalOceanDroplets/VestaCP/blob/master/files/v-search-command>
1111

1212
#----------------------------------------------------------#
1313
# Variables & Functions #

docs/docs/reference/cli.md

Lines changed: 51 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,5 @@
11
# CLI Reference
22

3-
::: info
4-
This page is work in progress. Information might be missing or misleading.
5-
:::
6-
73
## v-acknowledge-user-notification
84

95
update user notification
@@ -262,12 +258,12 @@ This function adds new rule to system firewall
262258

263259
add firewall ipset
264260

265-
**Options**: `NAME` `[SOURCE]` `[IPVERSION]` `[AUTOUPDATE]` `[FORCE]`
261+
**Options**: `NAME` `[SOURCE]` `[IPVERSION]` `[AUTOUPDATE]` `[REFRESH]`
266262

267263
**Examples**:
268264

269265
```bash
270-
v-add-firewall-ipset country-nl 'http://ipverse.net/ipblocks/data/countries/nl.zone'
266+
v-add-firewall-ipset country-nl "https://raw.githubusercontent.com/ipverse/rir-ip/master/country/nl/ipv4-aggregated.txt"
271267
```
272268

273269
This function adds new ipset to system firewall
@@ -1067,7 +1063,7 @@ add php fpm version
10671063
v-add-web-php 8.0
10681064
```
10691065

1070-
This function checks and delete a fpm php version if not used by any domain.
1066+
Install php-fpm for provided version.
10711067

10721068
## v-backup-user
10731069

@@ -2885,9 +2881,9 @@ for logging, notification and warn emails etc.
28852881

28862882
disable system wide smtp relay support
28872883

2888-
**Options**: ``
2884+
**Options**:
28892885

2890-
This function disables system wide smtp relay support.
2886+
options:
28912887

28922888
## v-delete-user
28932889

@@ -3288,6 +3284,18 @@ v-download-backup admin admin.2020-11-05_05-10-21.tar
32883284

32893285
This function download back-up from remote server
32903286

3287+
## v-export-rrd
3288+
3289+
export rrd charts as json
3290+
3291+
**Options**: `[CHART]` `[TIMESPAN]`
3292+
3293+
**Examples**:
3294+
3295+
```bash
3296+
v-export-rrd chart format
3297+
```
3298+
32913299
## v-extract-fs-archive
32923300

32933301
archive to directory
@@ -3326,7 +3334,7 @@ generate password hash
33263334
**Examples**:
33273335

33283336
```php
3329-
v-generate-password-hash sha-512 rAnDom_string yourPassWord
3337+
v-generate-password-hash sha-512 rAnDom_string yourPassWord
33303338
```
33313339

33323340
This function generates password hash
@@ -3451,6 +3459,22 @@ v-get-user-value admin FNAME
34513459

34523460
This function for obtaining certain user's parameters.
34533461

3462+
## v-import-cpanel
3463+
3464+
Import Cpanel backup to a new user
3465+
3466+
**Options**: `BACKUP` `[MX]`
3467+
3468+
**Examples**:
3469+
3470+
```bash
3471+
v-import-cpanel /backup/backup.tar.gz yes
3472+
```
3473+
3474+
Based on sk-import-cpanel-backup-to-vestacp
3475+
Credits: Maks Usmanov (skamasle) and contributors:
3476+
Thanks to <https://github.com/Skamasle/sk-import-cpanel-backup-to-vestacp/graphs/contributors>
3477+
34543478
## v-insert-dns-domain
34553479

34563480
insert dns domain
@@ -3963,33 +3987,33 @@ This function for obtaining the list of system parameters.
39633987

39643988
list system cpu info
39653989

3966-
**Options**: ``
3990+
**Options**:
39673991

3968-
This function lists cpu information
3992+
options:
39693993

39703994
## v-list-sys-db-status
39713995

39723996
list db status
39733997

3974-
**Options**: ``
3998+
**Options**:
39753999

3976-
v-list-sys-db-status
4000+
options:
39774001

39784002
## v-list-sys-disk-status
39794003

39804004
list disk information
39814005

3982-
**Options**: ``
4006+
**Options**:
39834007

3984-
This function lists disk information
4008+
options:
39854009

39864010
## v-list-sys-dns-status
39874011

39884012
list dns status
39894013

3990-
**Options**: ``
4014+
**Options**:
39914015

3992-
This function lists dns server status
4016+
options:
39934017

39944018
## v-list-sys-dovecot-config
39954019

@@ -4080,17 +4104,17 @@ Output is always in the ISO language code
40804104

40814105
list mail status
40824106

4083-
**Options**: ``
4107+
**Options**:
40844108

4085-
This function lists mail server status
4109+
options:
40864110

40874111
## v-list-sys-memory-status
40884112

40894113
list virtual memory info
40904114

4091-
**Options**: ``
4115+
**Options**:
40924116

4093-
This function lists virtual memory information
4117+
options:
40944118

40954119
## v-list-sys-mysql-config
40964120

@@ -4104,9 +4128,9 @@ This function for obtaining the list of mysql config parameters.
41044128

41054129
list system network status
41064130

4107-
**Options**: ``
4131+
**Options**:
41084132

4109-
This function lists network status
4133+
options:
41104134

41114135
## v-list-sys-nginx-config
41124136

@@ -4224,9 +4248,9 @@ This function for obtaining the list of vsftpd config parameters.
42244248

42254249
list web status
42264250

4227-
**Options**: ``
4251+
**Options**:
42284252

4229-
This function lists web server status
4253+
options:
42304254

42314255
## v-list-sys-webmail
42324256

@@ -4339,7 +4363,7 @@ This function for getting the list notifications
43394363

43404364
## v-list-user-ns
43414365

4342-
list user name servers
4366+
list user nameservers
43434367

43444368
**Options**: `USER` `[FORMAT]`
43454369

0 commit comments

Comments
 (0)