foster/forgejo-docs
0
0
Fork 0
mirror of https://codeberg.org/forgejo/docs.git synced 2024-11-20 17:26:56 -05:00
Code Issues Activity

docs: pick the Forgejo release from experimental (#542)

Browse source 
in the case of a release that is not yet published, it will exist as
release candidates in the experimental organization. Every release go
through there and it is a reliable source.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/542
Reviewed-by: crystal <crystal@noreply.codeberg.org>
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
This commit is contained in:
Earl Warren 2024-04-20 08:39:14 +00:00 committed by Earl Warren
parent bd8e4e588a
commit 4ce64e2840
2 changed files with 145 additions and 138 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

269
docs/admin/command-line.md
View file

@ -15,32 +15,33 @@ To update this page, run the following command from the root of the docs repo:
```
NAME:
Forgejo - Beyond coding. We forge.
forgejo - Beyond coding. We forge.
USAGE:
Forgejo [global options] command [command options] [arguments...]
forgejo [global options] command [command options]
DESCRIPTION:
By default, forgejo will start serving using the web-server with no argument, which can alternatively be run by running the subcommand "web".
COMMANDS:
help, h Shows a list of commands or help for one command
web Start the Forgejo web server
serv This command should only be called by SSH shell
hook Delegate commands to corresponding Git hooks
serv (internal) Should only be called by SSH shell
hook (internal) Should only be called by Git
keys (internal) Should only be called by SSH server
dump Dump Forgejo files and database
admin Command line interface to perform common administrative operations
admin Perform common administrative operations
migrate Migrate the database
keys This command queries the Forgejo database to get the authorized command for a given ssh key fingerprint
doctor Diagnose and optionally fix problems
doctor Diagnose and optionally fix problems, convert or re-create database tables
manager Manage the running forgejo process
embedded Extract embedded resources
migrate-storage Migrate the storage
dump-repo Dump the repository from git/github/gitea/gitlab
restore-repo Restore the repository from disk
help, h Shows a list of commands or help for one command
actions Manage Forgejo Actions
cert Generate self-signed certificate
generate Command line interface for running generators
generate Generate Gitea's secrets/keys/tokens
docs Output CLI documentation
forgejo-cli Forgejo CLI
@ -56,10 +57,10 @@ GLOBAL OPTIONS:
```
NAME:
Forgejo forgejo-cli - Forgejo CLI
forgejo forgejo-cli - Forgejo CLI
USAGE:
Forgejo forgejo-cli command [command options] [arguments...]
forgejo forgejo-cli command [command options]
COMMANDS:
actions Commands for managing Forgejo Actions
@ -73,10 +74,10 @@ OPTIONS:
```
NAME:
Forgejo forgejo-cli actions - Commands for managing Forgejo Actions
forgejo forgejo-cli actions - Commands for managing Forgejo Actions
USAGE:
Forgejo forgejo-cli actions command [command options] [arguments...]
forgejo forgejo-cli actions command [command options]
COMMANDS:
generate-runner-token Generate a new token for a runner to use to register with the server
@ -92,10 +93,10 @@ OPTIONS:
```
NAME:
Forgejo forgejo-cli actions generate-runner-token - Generate a new token for a runner to use to register with the server
forgejo forgejo-cli actions generate-runner-token - Generate a new token for a runner to use to register with the server
USAGE:
Forgejo forgejo-cli actions generate-runner-token [command options] [arguments...]
forgejo forgejo-cli actions generate-runner-token [command options] [arguments...]
OPTIONS:
--scope value, -s value {owner}[/{repo}] - leave empty for a global runner
@ -106,10 +107,10 @@ OPTIONS:
```
NAME:
Forgejo forgejo-cli actions generate-secret - Generate a secret suitable for input to the register subcommand
forgejo forgejo-cli actions generate-secret - Generate a secret suitable for input to the register subcommand
USAGE:
Forgejo forgejo-cli actions generate-secret [command options] [arguments...]
forgejo forgejo-cli actions generate-secret [command options] [arguments...]
OPTIONS:
--help, -h show help
@ -119,10 +120,10 @@ OPTIONS:
```
NAME:
Forgejo forgejo-cli actions register - Idempotent registration of a runner using a shared secret
forgejo forgejo-cli actions register - Idempotent registration of a runner using a shared secret
USAGE:
Forgejo forgejo-cli actions register [command options] [arguments...]
forgejo forgejo-cli actions register [command options] [arguments...]
OPTIONS:
--secret value the secret the runner will use to connect as a 40 character hexadecimal string
@ -139,10 +140,10 @@ OPTIONS:
```
NAME:
Forgejo web - Start the Forgejo web server
forgejo web - Start the Forgejo web server
USAGE:
Forgejo web command [command options] [arguments...]
forgejo web command [command options]
DESCRIPTION:
The Forgejo web server is the only thing you need to run,
@ -167,10 +168,10 @@ OPTIONS:
```
NAME:
Forgejo dump - Dump Forgejo files and database
forgejo dump - Dump Forgejo files and database
USAGE:
Forgejo dump command [command options] [arguments...]
forgejo dump command [command options]
DESCRIPTION:
Dump compresses all related files and database into zip file.
@ -188,7 +189,7 @@ OPTIONS:
--verbose, -V Show process details (default: false)
--quiet, -q Only display warnings and errors (default: false)
--tempdir value, -t value Temporary dir path (default: "/tmp")
--database value, -d value Specify the database SQL syntax: sqlite3, mysql, mssql, postgres
--database value, -d value Specify the database SQL syntax: sqlite3, mysql, postgres
--skip-repository, -R Skip the repository dumping (default: false)
--skip-log, -L Skip the log dumping (default: false)
--skip-custom-dir Skip custom directory (default: false)
@ -203,10 +204,10 @@ OPTIONS:
```
NAME:
Forgejo admin - Command line interface to perform common administrative operations
forgejo admin - Perform common administrative operations
USAGE:
Forgejo admin command [command options] [arguments...]
forgejo admin command [command options]
COMMANDS:
user Modify users
@ -227,10 +228,10 @@ OPTIONS:
```
NAME:
Forgejo admin user - Modify users
forgejo admin user - Modify users
USAGE:
Forgejo admin user command [command options] [arguments...]
forgejo admin user command [command options]
COMMANDS:
create Create a new user in database
@ -252,10 +253,10 @@ OPTIONS:
```
NAME:
Forgejo admin user create - Create a new user in database
forgejo admin user create - Create a new user in database
USAGE:
Forgejo admin user create command [command options] [arguments...]
forgejo admin user create command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -271,7 +272,7 @@ OPTIONS:
--email value User email address
--admin User is an admin (default: false)
--random-password Generate a random password for the user (default: false)
--must-change-password Set this option to false to prevent forcing the user to change their password after initial login, (Default: true) (default: false)
--must-change-password Set this option to false to prevent forcing the user to change their password after initial login (default: true)
--random-password-length value Length of the random password to be generated (default: 12)
--access-token Generate access token for the user (default: false)
--restricted Make a restricted user account (default: false)
@ -281,10 +282,10 @@ OPTIONS:
```
NAME:
Forgejo admin user list - List users
forgejo admin user list - List users
USAGE:
Forgejo admin user list command [command options] [arguments...]
forgejo admin user list command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -301,10 +302,10 @@ OPTIONS:
```
NAME:
Forgejo admin user change-password - Change a user's password
forgejo admin user change-password - Change a user's password
USAGE:
Forgejo admin user change-password command [command options] [arguments...]
forgejo admin user change-password command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -316,16 +317,17 @@ OPTIONS:
--work-path value, -w value Set Forgejo's working path (defaults to the directory of the Forgejo binary)
--username value, -u value The user to change password for
--password value, -p value New password to set for user
--must-change-password User must change password (default: false)
```
### admin user delete
```
NAME:
Forgejo admin user delete - Delete specific user by id, name or email
forgejo admin user delete - Delete specific user by id, name or email
USAGE:
Forgejo admin user delete command [command options] [arguments...]
forgejo admin user delete command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -345,10 +347,10 @@ OPTIONS:
```
NAME:
Forgejo admin user generate-access-token - Generate an access token for a specific user
forgejo admin user generate-access-token - Generate an access token for a specific user
USAGE:
Forgejo admin user generate-access-token command [command options] [arguments...]
forgejo admin user generate-access-token command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -368,10 +370,10 @@ OPTIONS:
```
NAME:
Forgejo admin user must-change-password - Set the must change password flag for the provided users or all users
forgejo admin user must-change-password - Set the must change password flag for the provided users or all users
USAGE:
Forgejo admin user must-change-password command [command options] [arguments...]
forgejo admin user must-change-password command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -390,10 +392,10 @@ OPTIONS:
```
NAME:
Forgejo admin repo-sync-releases - Synchronize repository releases with tags
forgejo admin repo-sync-releases - Synchronize repository releases with tags
USAGE:
Forgejo admin repo-sync-releases command [command options] [arguments...]
forgejo admin repo-sync-releases command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -409,10 +411,10 @@ OPTIONS:
```
NAME:
Forgejo admin regenerate - Regenerate specific files
forgejo admin regenerate - Regenerate specific files
USAGE:
Forgejo admin regenerate command [command options] [arguments...]
forgejo admin regenerate command [command options]
COMMANDS:
hooks Regenerate git-hooks
@ -430,10 +432,10 @@ OPTIONS:
```
NAME:
Forgejo admin auth - Modify external auth providers
forgejo admin auth - Modify external auth providers
USAGE:
Forgejo admin auth command [command options] [arguments...]
forgejo admin auth command [command options]
COMMANDS:
add-oauth Add new Oauth authentication source
@ -459,10 +461,10 @@ OPTIONS:
```
NAME:
Forgejo admin auth add-oauth - Add new Oauth authentication source
forgejo admin auth add-oauth - Add new Oauth authentication source
USAGE:
Forgejo admin auth add-oauth command [command options] [arguments...]
forgejo admin auth add-oauth command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -499,10 +501,10 @@ OPTIONS:
```
NAME:
Forgejo admin auth update-oauth - Update existing Oauth authentication source
forgejo admin auth update-oauth - Update existing Oauth authentication source
USAGE:
Forgejo admin auth update-oauth command [command options] [arguments...]
forgejo admin auth update-oauth command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -540,10 +542,10 @@ OPTIONS:
```
NAME:
Forgejo admin auth add-ldap - Add new LDAP (via Bind DN) authentication source
forgejo admin auth add-ldap - Add new LDAP (via Bind DN) authentication source
USAGE:
Forgejo admin auth add-ldap command [command options] [arguments...]
forgejo admin auth add-ldap command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -584,10 +586,10 @@ OPTIONS:
```
NAME:
Forgejo admin auth update-ldap - Update existing LDAP (via Bind DN) authentication source
forgejo admin auth update-ldap - Update existing LDAP (via Bind DN) authentication source
USAGE:
Forgejo admin auth update-ldap command [command options] [arguments...]
forgejo admin auth update-ldap command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -629,10 +631,10 @@ OPTIONS:
```
NAME:
Forgejo admin auth add-ldap-simple - Add new LDAP (simple auth) authentication source
forgejo admin auth add-ldap-simple - Add new LDAP (simple auth) authentication source
USAGE:
Forgejo admin auth add-ldap-simple command [command options] [arguments...]
forgejo admin auth add-ldap-simple command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -661,17 +663,17 @@ OPTIONS:
--public-ssh-key-attribute value The attribute of the user’s LDAP record containing the user’s public ssh key.
--skip-local-2fa Set to true to skip local 2fa for users authenticated by this source (default: false)
--avatar-attribute value The attribute of the user’s LDAP record containing the user’s avatar.
--user-dn value The user’s DN.
--user-dn value The user's DN.
```
### admin auth update-ldap-simple
```
NAME:
Forgejo admin auth update-ldap-simple - Update existing LDAP (simple auth) authentication source
forgejo admin auth update-ldap-simple - Update existing LDAP (simple auth) authentication source
USAGE:
Forgejo admin auth update-ldap-simple command [command options] [arguments...]
forgejo admin auth update-ldap-simple command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -701,17 +703,17 @@ OPTIONS:
--public-ssh-key-attribute value The attribute of the user’s LDAP record containing the user’s public ssh key.
--skip-local-2fa Set to true to skip local 2fa for users authenticated by this source (default: false)
--avatar-attribute value The attribute of the user’s LDAP record containing the user’s avatar.
--user-dn value The user’s DN.
--user-dn value The user's DN.
```
### admin auth add-smtp
```
NAME:
Forgejo admin auth add-smtp - Add new SMTP authentication source
forgejo admin auth add-smtp - Add new SMTP authentication source
USAGE:
Forgejo admin auth add-smtp command [command options] [arguments...]
forgejo admin auth add-smtp command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -738,10 +740,10 @@ OPTIONS:
```
NAME:
Forgejo admin auth update-smtp - Update existing SMTP authentication source
forgejo admin auth update-smtp - Update existing SMTP authentication source
USAGE:
Forgejo admin auth update-smtp command [command options] [arguments...]
forgejo admin auth update-smtp command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -769,10 +771,10 @@ OPTIONS:
```
NAME:
Forgejo admin auth list - List auth sources
forgejo admin auth list - List auth sources
USAGE:
Forgejo admin auth list command [command options] [arguments...]
forgejo admin auth list command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -793,10 +795,10 @@ OPTIONS:
```
NAME:
Forgejo admin auth delete - Delete specific auth source
forgejo admin auth delete - Delete specific auth source
USAGE:
Forgejo admin auth delete command [command options] [arguments...]
forgejo admin auth delete command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -813,10 +815,10 @@ OPTIONS:
```
NAME:
Forgejo admin sendmail - Send a message to all users
forgejo admin sendmail - Send a message to all users
USAGE:
Forgejo admin sendmail command [command options] [arguments...]
forgejo admin sendmail command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -835,10 +837,10 @@ OPTIONS:
```
NAME:
Forgejo migrate - Migrate the database
forgejo migrate - Migrate the database
USAGE:
Forgejo migrate command [command options] [arguments...]
forgejo migrate command [command options]
DESCRIPTION:
This is a command for migrating the database, so that you can run gitea admin create-user before starting the server.
@ -857,10 +859,13 @@ OPTIONS:
```
NAME:
Forgejo keys - This command queries the Forgejo database to get the authorized command for a given ssh key fingerprint
forgejo keys - (internal) Should only be called by SSH server
USAGE:
Forgejo keys command [command options] [arguments...]
forgejo keys command [command options]
DESCRIPTION:
Queries the Forgejo database to get the authorized command for a given ssh key fingerprint
COMMANDS:
help, h Shows a list of commands or help for one command
@ -880,10 +885,10 @@ OPTIONS:
```
NAME:
Forgejo doctor - Diagnose and optionally fix problems
forgejo doctor - Diagnose and optionally fix problems, convert or re-create database tables
USAGE:
Forgejo doctor command [command options] [arguments...]
forgejo doctor command [command options]
DESCRIPTION:
A command to diagnose problems with the current Forgejo instance according to the given configuration. Some problems can optionally be fixed by modifying the database or data storage.
@ -905,10 +910,10 @@ OPTIONS:
```
NAME:
Forgejo doctor check - Diagnose and optionally fix problems
forgejo doctor check - Diagnose and optionally fix problems
USAGE:
Forgejo doctor check command [command options] [arguments...]
forgejo doctor check command [command options]
DESCRIPTION:
A command to diagnose problems with the current Forgejo instance according to the given configuration. Some problems can optionally be fixed by modifying the database or data storage.
@ -934,10 +939,10 @@ OPTIONS:
```
NAME:
Forgejo doctor recreate-table - Recreate tables from XORM definitions and copy the data.
forgejo doctor recreate-table - Recreate tables from XORM definitions and copy the data.
USAGE:
Forgejo doctor recreate-table command [command options] [TABLE]... : (TABLEs to recreate - leave blank for all)
forgejo doctor recreate-table command [command options] [TABLE]... : (TABLEs to recreate - leave blank for all)
DESCRIPTION:
The database definitions Forgejo uses change across versions, sometimes changing default values and leaving old unused columns.
@ -961,13 +966,13 @@ OPTIONS:
```
NAME:
Forgejo doctor convert - Convert the database
forgejo doctor convert - Convert the database
USAGE:
Forgejo doctor convert command [command options] [arguments...]
forgejo doctor convert command [command options]
DESCRIPTION:
A command to convert an existing MySQL database from utf8 to utf8mb4 or MSSQL database from varchar to nvarchar
A command to convert an existing MySQL database from utf8 to utf8mb4
COMMANDS:
help, h Shows a list of commands or help for one command
@ -983,10 +988,10 @@ OPTIONS:
```
NAME:
Forgejo manager - Manage the running forgejo process
forgejo manager - Manage the running forgejo process
USAGE:
Forgejo manager command [command options] [arguments...]
forgejo manager command [command options]
DESCRIPTION:
This is a command for managing the running forgejo process
@ -1011,10 +1016,10 @@ OPTIONS:
```
NAME:
Forgejo manager shutdown - Gracefully shutdown the running process
forgejo manager shutdown - Gracefully shutdown the running process
USAGE:
Forgejo manager shutdown command [command options] [arguments...]
forgejo manager shutdown command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1031,10 +1036,10 @@ OPTIONS:
```
NAME:
Forgejo manager restart - Gracefully restart the running process - (not implemented for windows servers)
forgejo manager restart - Gracefully restart the running process - (not implemented for windows servers)
USAGE:
Forgejo manager restart command [command options] [arguments...]
forgejo manager restart command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1051,10 +1056,10 @@ OPTIONS:
```
NAME:
Forgejo manager reload-templates - Reload template files in the running process
forgejo manager reload-templates - Reload template files in the running process
USAGE:
Forgejo manager reload-templates command [command options] [arguments...]
forgejo manager reload-templates command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1071,10 +1076,10 @@ OPTIONS:
```
NAME:
Forgejo manager flush-queues - Flush queues in the running process
forgejo manager flush-queues - Flush queues in the running process
USAGE:
Forgejo manager flush-queues command [command options] [arguments...]
forgejo manager flush-queues command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1093,10 +1098,10 @@ OPTIONS:
```
NAME:
Forgejo manager logging - Adjust logging commands
forgejo manager logging - Adjust logging commands
USAGE:
Forgejo manager logging command [command options] [arguments...]
forgejo manager logging command [command options]
COMMANDS:
pause Pause logging (Forgejo will buffer logs up to a certain point and will drop them after that point)
@ -1118,10 +1123,10 @@ OPTIONS:
```
NAME:
Forgejo manager logging pause - Pause logging (Forgejo will buffer logs up to a certain point and will drop them after that point)
forgejo manager logging pause - Pause logging (Forgejo will buffer logs up to a certain point and will drop them after that point)
USAGE:
Forgejo manager logging pause command [command options] [arguments...]
forgejo manager logging pause command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1138,10 +1143,10 @@ OPTIONS:
```
NAME:
Forgejo manager logging resume - Resume logging
forgejo manager logging resume - Resume logging
USAGE:
Forgejo manager logging resume command [command options] [arguments...]
forgejo manager logging resume command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1158,10 +1163,10 @@ OPTIONS:
```
NAME:
Forgejo manager logging release-and-reopen - Cause Forgejo to release and re-open files used for logging
forgejo manager logging release-and-reopen - Cause Forgejo to release and re-open files used for logging
USAGE:
Forgejo manager logging release-and-reopen command [command options] [arguments...]
forgejo manager logging release-and-reopen command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1178,10 +1183,10 @@ OPTIONS:
```
NAME:
Forgejo manager logging remove - Remove a logger
forgejo manager logging remove - Remove a logger
USAGE:
Forgejo manager logging remove command [command options] [name] Name of logger to remove
forgejo manager logging remove command [command options] [name] Name of logger to remove
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1199,10 +1204,10 @@ OPTIONS:
```
NAME:
Forgejo manager logging add - Add a logger
forgejo manager logging add - Add a logger
USAGE:
Forgejo manager logging add command [command options] [arguments...]
forgejo manager logging add command [command options]
COMMANDS:
file Add a file logger
@ -1220,10 +1225,10 @@ OPTIONS:
```
NAME:
Forgejo manager logging add file - Add a file logger
forgejo manager logging add file - Add a file logger
USAGE:
Forgejo manager logging add file command [command options] [arguments...]
forgejo manager logging add file command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1255,10 +1260,10 @@ OPTIONS:
```
NAME:
Forgejo manager logging add conn - Add a net conn logger
forgejo manager logging add conn - Add a net conn logger
USAGE:
Forgejo manager logging add conn command [command options] [arguments...]
forgejo manager logging add conn command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1287,10 +1292,10 @@ OPTIONS:
```
NAME:
Forgejo manager logging log-sql - Set LogSQL
forgejo manager logging log-sql - Set LogSQL
USAGE:
Forgejo manager logging log-sql command [command options] [arguments...]
forgejo manager logging log-sql command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1308,10 +1313,10 @@ OPTIONS:
```
NAME:
Forgejo manager processes - Display running processes within the current process
forgejo manager processes - Display running processes within the current process
USAGE:
Forgejo manager processes command [command options] [arguments...]
forgejo manager processes command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1333,10 +1338,10 @@ OPTIONS:
```
NAME:
Forgejo embedded - Extract embedded resources
forgejo embedded - Extract embedded resources
USAGE:
Forgejo embedded command [command options] [arguments...]
forgejo embedded command [command options]
DESCRIPTION:
A command for extracting embedded resources, like templates and images
@ -1358,10 +1363,10 @@ OPTIONS:
```
NAME:
Forgejo embedded list - List files matching the given pattern
forgejo embedded list - List files matching the given pattern
USAGE:
Forgejo embedded list command [command options] [arguments...]
forgejo embedded list command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1378,10 +1383,10 @@ OPTIONS:
```
NAME:
Forgejo embedded view - View a file matching the given pattern
forgejo embedded view - View a file matching the given pattern
USAGE:
Forgejo embedded view command [command options] [arguments...]
forgejo embedded view command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1398,10 +1403,10 @@ OPTIONS:
```
NAME:
Forgejo embedded extract - Extract resources
forgejo embedded extract - Extract resources
USAGE:
Forgejo embedded extract command [command options] [arguments...]
forgejo embedded extract command [command options]
COMMANDS:
help, h Shows a list of commands or help for one command
@ -1422,10 +1427,10 @@ OPTIONS:
```
NAME:
Forgejo migrate-storage - Migrate the storage
forgejo migrate-storage - Migrate the storage
USAGE:
Forgejo migrate-storage command [command options] [arguments...]
forgejo migrate-storage command [command options]
DESCRIPTION:
Copies stored files from storage configured in app.ini to parameter-configured storage
@ -1456,10 +1461,10 @@ OPTIONS:
```
NAME:
Forgejo dump-repo - Dump the repository from git/github/gitea/gitlab
forgejo dump-repo - Dump the repository from git/github/gitea/gitlab
USAGE:
Forgejo dump-repo command [command options] [arguments...]
forgejo dump-repo command [command options]
DESCRIPTION:
This is a command for dumping the repository data.
@ -1488,10 +1493,10 @@ OPTIONS:
```
NAME:
Forgejo restore-repo - Restore the repository from disk
forgejo restore-repo - Restore the repository from disk
USAGE:
Forgejo restore-repo command [command options] [arguments...]
forgejo restore-repo command [command options]
DESCRIPTION:
This is a command for restoring the repository data.
@ -1516,10 +1521,10 @@ OPTIONS:
```
NAME:
Forgejo cert - Generate self-signed certificate
forgejo cert - Generate self-signed certificate
USAGE:
Forgejo cert [command options] [arguments...]
forgejo cert [command options] [arguments...]
DESCRIPTION:
Generate a self-signed X.509 certificate for a TLS server.
@ -1539,10 +1544,10 @@ OPTIONS:
```
NAME:
Forgejo generate secret - Generate a secret token
forgejo generate secret - Generate a secret token
USAGE:
Forgejo generate secret command [command options] [arguments...]
forgejo generate secret command [command options]
COMMANDS:
INTERNAL_TOKEN Generate a new INTERNAL_TOKEN

14
scripts/cli-docs.sh
View file

@ -2,7 +2,7 @@
set -e
: ${FORGEJO:=/tmp/forgejo}
: ${FORGEJO:=/tmp/forgejo-binary}
function dependencies() {
if ! which jq curl > /dev/null ; then
@ -15,20 +15,21 @@ function latest() {
local major="$1"
if test "$major" = "next" ; then
curl -sS https://codeberg.org/api/v1/repos/forgejo/forgejo/releases | jq -r '.[] | .tag_name' | sort -r | head -1
select="" # this will pick whatever is the highest numbered release
else
curl -sS https://codeberg.org/api/v1/repos/forgejo/forgejo/releases | jq -r '.[] | .tag_name | select(startswith("'$major'"))' | sort -r | head -1
select="$major"
fi
curl -sS https://codeberg.org/api/v1/repos/forgejo-experimental/forgejo/releases | jq -r '.[] | .tag_name | select(startswith("'$select'"))' | sort --reverse --version-sort | head -1
}
function download() {
local major="$1"
if test -f /tmp/forgejo ; then
if test -f $FORGEJO ; then
return
fi
local version=$(latest $major)
curl -sS "https://codeberg.org/forgejo/forgejo/releases/download/${version}/forgejo-${version#v}-linux-amd64" > ${FORGEJO}
curl -sS "https://codeberg.org/forgejo-experimental/forgejo/releases/download/${version}/forgejo-${version#v}-linux-amd64" > ${FORGEJO}
chmod +x ${FORGEJO}
}
@ -155,7 +156,8 @@ function generate() {
function cleanup() {
sed \
-e 's/forgejo-dump-.*.zip/forgejo-dump-<timestamp>.zip/' \
-e '/^ *actions *$/d'
-e '/^ *actions *$/d' \
-e 's/ *$//'
}
function run() {