forgejo(1)
| Forgejo(8) | System Manager's Manual | Forgejo(8) |
NAME
Forgejo - Beyond coding. We forge.
SYNOPSIS
Forgejo
[--config|-c]=[value] [--custom-path|-C]=[value] [--help|-h] [--version|-v] [--work-path|-w]=[value]
DESCRIPTION
By default, forgejo will start serving using the web-server with no argument, which can alternatively be run by running the subcommand "web".
Usage:
Forgejo [GLOBAL OPTIONS] command [COMMAND OPTIONS] [ARGUMENTS...]
GLOBAL OPTIONS
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--version, -v: print the version
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
COMMANDS
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
web
Start the Forgejo web server
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--install-port="": Temporary port number to run the install page on to prevent conflict (default: "3000")
--pid, -P="": Custom pid file path (default: "/run/gitea.pid")
--port, -p="": Temporary port number to prevent conflict (default: "3000")
--quiet, -q: Only display Fatal logging errors until logging is set-up
--verbose: Set initial logging to TRACE level until logging is properly set-up
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
serv
(internal) Should only be called by SSH shell
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--enable-pprof:
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
hook
(internal) Should only be called by Git
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
pre-receive
Delegate pre-receive Git hook
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
update
Delegate update Git hook
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
post-receive
Delegate post-receive Git hook
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
proc-receive
Delegate proc-receive Git hook
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
keys
(internal) Should only be called by SSH server
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--content, -k="": Base64 encoded content of the SSH key provided to the SSH Server (requires type to be provided too)
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--expected, -e="": Expected user for whom provide key commands (default: "git")
--help, -h: show help
--type, -t="": Type of the SSH key provided to the SSH Server (requires content to be provided too)
--username, -u="": Username trying to log in by SSH
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
dump
Dump Forgejo files and database
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--database, -d="": Specify the database SQL syntax: sqlite3, mysql, postgres
--file, -f="": Name of the dump file which will be created. Supply '-' for stdout. See type for available types. (default: "forgejo-dump-1783602050.zip")
--help, -h: show help
--quiet, -q: Only display warnings and errors
--skip-attachment-data: Skip attachment data
--skip-custom-dir: Skip custom directory
--skip-index: Skip bleve index data
--skip-lfs-data: Skip LFS data
--skip-log, -L: Skip logs
--skip-package-data: Skip package data
--skip-repo-archives: Skip repository archives
--skip-repository, -R: Skip repositories
--tempdir, -t="": Temporary dir path (default: "/usr/src/tmp")
--type="": Dump output format: zip, tar, tar.sz, tar.gz, tar.xz, tar.bz2, tar.br, tar.lz4, tar.zst (default: zip)
--verbose, -V: Show process details
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
admin
Perform common administrative operations
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
user
Modify users
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
create
Create a new user in database
--access-token: Generate access token for the user
--admin: User is an admin
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--email="": User email address
--help, -h: show help
--must-change-password: Set this option to false to prevent forcing the user to change their password after initial login
--name="": Username. DEPRECATED: use username instead
--password="": User password
--random-password: Generate a random password for the user
--random-password-length="": Length of the random password to be generated (default: 12)
--restricted: Make a restricted user account
--username="": Username
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
list
List users
--admin: List only admin users
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
change-password
Change a user's password
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--must-change-password: User must change password
--password, -p="": New password to set for user
--username, -u="": The user to change password for
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
delete
Delete specific user by id, name or email
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--email, -e="": Email of the user to delete
--help, -h: show help
--id="": ID of user of the user to delete (default: 0)
--purge: Purge user, all their repositories, organizations and comments
--username, -u="": Username of the user to delete
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
generate-access-token
Generate an access token for a specific user
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--raw: Display only the token value
--scopes="": Comma separated list of scopes to apply to access token
--token-name, -t="": Token name (default: "gitea-admin")
--username, -u="": Username
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
must-change-password
Set the must change password flag for the provided users or all users
--all, -A: All users must change password, except those explicitly excluded with --exclude
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--exclude, -e="": Do not change the must-change-password flag for these users
--help, -h: show help
--unset: Instead of setting the must-change-password flag, unset it
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
repo-sync-releases
Synchronize repository releases with tags
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
regenerate
Regenerate specific files
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
hooks
Regenerate git-hooks
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
keys
Regenerate authorized_keys file
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
auth
Modify external auth providers
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
add-oauth
Add new Oauth authentication source
--admin-group="": Group Claim value for administrator users
--auto-discover-url="": OpenID Connect Auto Discovery URL (only required when using OpenID Connect as provider)
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-auth-url="": Use a custom Authorization URL (option for GitLab/GitHub)
--custom-email-url="": Use a custom Email URL (option for GitHub)
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--custom-profile-url="": Use a custom Profile URL (option for GitLab/GitHub)
--custom-tenant-id="": Use custom Tenant ID for OAuth endpoints
--custom-token-url="": Use a custom Token URL (option for GitLab/GitHub)
--group-claim-name="": Claim name providing group names for this source
--group-team-map="": JSON mapping between groups and org teams
--group-team-map-removal: Activate automatic team membership removal depending on groups
--help, -h: show help
--icon-url="": Custom icon URL for OAuth2 login source
--key="": Client ID (Key)
--name="": Application Name
--provider="": OAuth2 Provider
--required-claim-name="": Claim name that has to be set to allow users to login with this source
--required-claim-value="": Claim value that has to be set to allow users to login with this source
--restricted-group="": Group Claim value for restricted users
--scopes="": Scopes to request when to authenticate against this OAuth2 source
--secret="": Client Secret
--skip-local-2fa: Set to true to skip local 2fa for users authenticated by this source
--use-custom-urls="": Use custom URLs for GitLab/GitHub OAuth endpoints (default: "false")
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
update-oauth
Update existing Oauth authentication source
--admin-group="": Group Claim value for administrator users
--auto-discover-url="": OpenID Connect Auto Discovery URL (only required when using OpenID Connect as provider)
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-auth-url="": Use a custom Authorization URL (option for GitLab/GitHub)
--custom-email-url="": Use a custom Email URL (option for GitHub)
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--custom-profile-url="": Use a custom Profile URL (option for GitLab/GitHub)
--custom-tenant-id="": Use custom Tenant ID for OAuth endpoints
--custom-token-url="": Use a custom Token URL (option for GitLab/GitHub)
--group-claim-name="": Claim name providing group names for this source
--group-team-map="": JSON mapping between groups and org teams
--group-team-map-removal: Activate automatic team membership removal depending on groups
--help, -h: show help
--icon-url="": Custom icon URL for OAuth2 login source
--id="": ID of authentication source (default: 0)
--key="": Client ID (Key)
--name="": Application Name
--provider="": OAuth2 Provider
--required-claim-name="": Claim name that has to be set to allow users to login with this source
--required-claim-value="": Claim value that has to be set to allow users to login with this source
--restricted-group="": Group Claim value for restricted users
--scopes="": Scopes to request when to authenticate against this OAuth2 source
--secret="": Client Secret
--skip-local-2fa: Set to true to skip local 2fa for users authenticated by this source
--use-custom-urls="": Use custom URLs for GitLab/GitHub OAuth endpoints (default: "false")
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
add-ldap
Add new LDAP (via Bind DN) authentication source
--active: Activate the authentication source.
--admin-filter="": An LDAP filter specifying if a user should be given administrator privileges.
--allow-deactivate-all: Allow empty search results to deactivate all users.
--attributes-in-bind: Fetch attributes in bind DN context.
--avatar-attribute="": The attribute of the user’s LDAP record containing the user’s avatar.
--bind-dn="": The DN to bind to the LDAP server with when searching for the user.
--bind-password="": The password for the Bind DN, if any.
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--disable-synchronize-users: Disable user synchronization.
--email-attribute="": The attribute of the user’s LDAP record containing the user’s email address.
--firstname-attribute="": The attribute of the user’s LDAP record containing the user’s first name.
--help, -h: show help
--host="": The address where the LDAP server can be reached.
--name="": Authentication name.
--not-active: Deactivate the authentication source.
--page-size="": Search page size. (default: 0)
--port="": The port to use when connecting to the LDAP server. (default: 0)
--public-ssh-key-attribute="": The attribute of the user’s LDAP record containing the user’s public ssh key.
--restricted-filter="": An LDAP filter specifying if a user should be given restricted status.
--security-protocol="": Security protocol name.
--skip-local-2fa: Set to true to skip local 2fa for users authenticated by this source
--skip-tls-verify: Disable TLS verification.
--surname-attribute="": The attribute of the user’s LDAP record containing the user’s surname.
--synchronize-users: Enable user synchronization.
--user-filter="": An LDAP filter declaring how to find the user record that is attempting to authenticate.
--user-search-base="": The LDAP base at which user accounts will be searched for.
--username-attribute="": The attribute of the user’s LDAP record containing the user name.
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
update-ldap
Update existing LDAP (via Bind DN) authentication source
--active: Activate the authentication source.
--admin-filter="": An LDAP filter specifying if a user should be given administrator privileges.
--allow-deactivate-all: Allow empty search results to deactivate all users.
--attributes-in-bind: Fetch attributes in bind DN context.
--avatar-attribute="": The attribute of the user’s LDAP record containing the user’s avatar.
--bind-dn="": The DN to bind to the LDAP server with when searching for the user.
--bind-password="": The password for the Bind DN, if any.
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--disable-synchronize-users: Disable user synchronization.
--email-attribute="": The attribute of the user’s LDAP record containing the user’s email address.
--firstname-attribute="": The attribute of the user’s LDAP record containing the user’s first name.
--help, -h: show help
--host="": The address where the LDAP server can be reached.
--id="": ID of authentication source (default: 0)
--name="": Authentication name.
--not-active: Deactivate the authentication source.
--page-size="": Search page size. (default: 0)
--port="": The port to use when connecting to the LDAP server. (default: 0)
--public-ssh-key-attribute="": The attribute of the user’s LDAP record containing the user’s public ssh key.
--restricted-filter="": An LDAP filter specifying if a user should be given restricted status.
--security-protocol="": Security protocol name.
--skip-local-2fa: Set to true to skip local 2fa for users authenticated by this source
--skip-tls-verify: Disable TLS verification.
--surname-attribute="": The attribute of the user’s LDAP record containing the user’s surname.
--synchronize-users: Enable user synchronization.
--user-filter="": An LDAP filter declaring how to find the user record that is attempting to authenticate.
--user-search-base="": The LDAP base at which user accounts will be searched for.
--username-attribute="": The attribute of the user’s LDAP record containing the user name.
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
add-ldap-simple
Add new LDAP (simple auth) authentication source
--active: Activate the authentication source.
--admin-filter="": An LDAP filter specifying if a user should be given administrator privileges.
--allow-deactivate-all: Allow empty search results to deactivate all users.
--avatar-attribute="": The attribute of the user’s LDAP record containing the user’s avatar.
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--email-attribute="": The attribute of the user’s LDAP record containing the user’s email address.
--firstname-attribute="": The attribute of the user’s LDAP record containing the user’s first name.
--help, -h: show help
--host="": The address where the LDAP server can be reached.
--name="": Authentication name.
--not-active: Deactivate the authentication source.
--port="": The port to use when connecting to the LDAP server. (default: 0)
--public-ssh-key-attribute="": The attribute of the user’s LDAP record containing the user’s public ssh key.
--restricted-filter="": An LDAP filter specifying if a user should be given restricted status.
--security-protocol="": Security protocol name.
--skip-local-2fa: Set to true to skip local 2fa for users authenticated by this source
--skip-tls-verify: Disable TLS verification.
--surname-attribute="": The attribute of the user’s LDAP record containing the user’s surname.
--user-dn="": The user's DN.
--user-filter="": An LDAP filter declaring how to find the user record that is attempting to authenticate.
--user-search-base="": The LDAP base at which user accounts will be searched for.
--username-attribute="": The attribute of the user’s LDAP record containing the user name.
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
update-ldap-simple
Update existing LDAP (simple auth) authentication source
--active: Activate the authentication source.
--admin-filter="": An LDAP filter specifying if a user should be given administrator privileges.
--allow-deactivate-all: Allow empty search results to deactivate all users.
--avatar-attribute="": The attribute of the user’s LDAP record containing the user’s avatar.
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--email-attribute="": The attribute of the user’s LDAP record containing the user’s email address.
--firstname-attribute="": The attribute of the user’s LDAP record containing the user’s first name.
--help, -h: show help
--host="": The address where the LDAP server can be reached.
--id="": ID of authentication source (default: 0)
--name="": Authentication name.
--not-active: Deactivate the authentication source.
--port="": The port to use when connecting to the LDAP server. (default: 0)
--public-ssh-key-attribute="": The attribute of the user’s LDAP record containing the user’s public ssh key.
--restricted-filter="": An LDAP filter specifying if a user should be given restricted status.
--security-protocol="": Security protocol name.
--skip-local-2fa: Set to true to skip local 2fa for users authenticated by this source
--skip-tls-verify: Disable TLS verification.
--surname-attribute="": The attribute of the user’s LDAP record containing the user’s surname.
--user-dn="": The user's DN.
--user-filter="": An LDAP filter declaring how to find the user record that is attempting to authenticate.
--user-search-base="": The LDAP base at which user accounts will be searched for.
--username-attribute="": The attribute of the user’s LDAP record containing the user name.
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
add-smtp
Add new SMTP authentication source
--active: This Authentication Source is Activated.
--allowed-domains="": Leave empty to allow all domains. Separate multiple domains with a comma (',')
--auth-type="": SMTP Authentication Type (PLAIN/LOGIN/CRAM-MD5) default PLAIN (default: "PLAIN")
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--disable-helo: Disable SMTP helo.
--force-smtps: SMTPS is always used on port 465. Set this to force SMTPS on other ports.
--helo-hostname="": Hostname sent with HELO. Leave blank to send current hostname
--help, -h: show help
--host="": SMTP Host
--name="": Application Name
--port="": SMTP Port (default: 0)
--skip-local-2fa: Skip 2FA to log on.
--skip-verify: Skip TLS verify.
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
update-smtp
Update existing SMTP authentication source
--active: This Authentication Source is Activated.
--allowed-domains="": Leave empty to allow all domains. Separate multiple domains with a comma (',')
--auth-type="": SMTP Authentication Type (PLAIN/LOGIN/CRAM-MD5) default PLAIN (default: "PLAIN")
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--disable-helo: Disable SMTP helo.
--force-smtps: SMTPS is always used on port 465. Set this to force SMTPS on other ports.
--helo-hostname="": Hostname sent with HELO. Leave blank to send current hostname
--help, -h: show help
--host="": SMTP Host
--id="": ID of authentication source (default: 0)
--name="": Application Name
--port="": SMTP Port (default: 0)
--skip-local-2fa: Skip 2FA to log on.
--skip-verify: Skip TLS verify.
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
list
List auth sources
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--min-width="": Minimal cell width including any padding for the formatted table (default: 0)
--pad-char="": ASCII char used for padding if padchar == '\t', the Writer will assume that the width of a '\t' in the formatted output is tabwidth, and cells are left-aligned independent of align_left (for correct-looking results, tabwidth must correspond to the tab width in the viewer displaying the result) (default: "\t")
--padding="": padding added to a cell before computing its width (default: 1)
--tab-width="": width of tab characters in formatted table (equivalent number of spaces) (default: 8)
--vertical-bars: Set to true to print vertical bars between columns
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
delete
Delete specific auth source
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--id="": ID of authentication source (default: 0)
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
sendmail
Send a message to all users
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--content="": a content of a message
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--force, -f: A flag to bypass a confirmation step
--help, -h: show help
--title="": a title of a message
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
migrate
Migrate the database
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
doctor
Diagnose and optionally fix problems, convert or re-create database tables
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
check
Diagnose and optionally fix problems
--all: Run all the available checks
--color, -H: Use color for outputted information
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--default: Run the default checks (if neither --run or --all is set, this is the default behaviour)
--fix: Automatically fix what we can
--help, -h: show help
--list: List the available checks
--log-file="": Name of the log file (no verbose log output by default). Set to "-" to output to stdout
--run="": Run the provided checks - (if --default is set, the default checks will also run)
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
recreate-table
Recreate tables from XORM definitions and copy the data.
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug: Print SQL commands sent
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
convert
Convert the database
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
cleanup-commit-status
Cleanup extra records in commit_status table
--buffer-size="": Record count per query while iterating records; larger values are typically faster but use more memory (default: 100000)
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--delete-chunk-size="": Number of records to delete per DELETE query (default: 1000)
--dry-run: Report statistics from the operation but do not modify the database
--help, -h: show help
--verbose, -V: Show process details
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
manager
Manage the running forgejo process
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
shutdown
Gracefully shutdown the running process
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
restart
Gracefully restart the running process - (not implemented for windows servers)
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
reload-templates
Reload template files in the running process
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
flush-queues
Flush queues in the running process
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--help, -h: show help
--non-blocking: Set to true to not wait for flush to complete before returning
--timeout="": Timeout for the flushing process (default: 1m0s)
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
logging
Adjust logging commands
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
pause
Pause logging (Forgejo will buffer logs up to a certain point and will drop them after that point)
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
resume
Resume logging
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
release-and-reopen
Cause Forgejo to release and re-open files used for logging
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
remove
Remove a logger
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--help, -h: show help
--logger="": Logger name - will default to "default"
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
add
Add a logger
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
file
Add a file logger
--color: Use color in the logs
--compress, -z: Compress rotated logs
--compression-level, -Z="": Compression level to use (default: 0)
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--daily, -d: Rotate logs daily
--debug:
--expression, -e="": Matching expression for the logger
--filename, -f="": Filename for the logger - this must be set.
--flags, -F="": Flags for the logger
--help, -h: show help
--level="": Logging level for the new logger
--logger="": Logger name - will default to "default"
--max-days, -D="": Maximum number of daily logs to keep (default: 0)
--max-size, -s="": Maximum size in bytes before rotation (default: 0)
--prefix, -p="": Prefix for the logger
--rotate, -r: Rotate logs
--stacktrace-level, -L="": Stacktrace logging level
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
--writer="": Name of the log writer - will default to mode
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
conn
Add a net conn logger
--address, -a="": Host address and port to connect to (defaults to :7020)
--color: Use color in the logs
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--expression, -e="": Matching expression for the logger
--flags, -F="": Flags for the logger
--help, -h: show help
--level="": Logging level for the new logger
--logger="": Logger name - will default to "default"
--prefix, -p="": Prefix for the logger
--protocol, -P="": Set protocol to use: tcp, unix, or udp (defaults to tcp)
--reconnect, -r: Reconnect to host when connection is dropped
--reconnect-on-message, -R: Reconnect to host for every message
--stacktrace-level, -L="": Stacktrace logging level
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
--writer="": Name of the log writer - will default to mode
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
log-sql
Set LogSQL
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--help, -h: show help
--off: Switch off SQL logging
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
processes
Display running processes within the current process
--cancel="": Process PID to cancel. (Only available for non-system processes.)
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--debug:
--flat: Show processes as flat table rather than as tree
--help, -h: show help
--json: Output as json
--no-system: Do not show system processes
--stacktraces: Show stacktraces
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
embedded
Extract embedded resources
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
list
List files matching the given pattern
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--include-vendored, --vendor: Include files under public/vendor as well
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
view
View a file matching the given pattern
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--include-vendored, --vendor: Include files under public/vendor as well
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
extract
Extract resources
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom: Extract to the 'custom' directory as per app.ini
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--destination, --dest-dir="": Extract to the specified directory
--help, -h: show help
--include-vendored, --vendor: Include files under public/vendor as well
--overwrite: Overwrite files if they already exist
--rename: Rename files as {name}.bak if they already exist (overwrites previous .bak)
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
migrate-storage
Migrate the storage
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--minio-access-key-id="": Minio storage accessKeyID
--minio-base-path="": Minio storage base path on the bucket
--minio-bucket="": Minio storage bucket
--minio-checksum-algorithm="": Minio checksum algorithm (default/md5)
--minio-endpoint="": Minio storage endpoint
--minio-insecure-skip-verify: Skip SSL verification
--minio-location="": Minio storage location to create bucket
--minio-secret-access-key="": Minio storage secretAccessKey
--minio-use-ssl: Enable SSL for minio
--path, -p="": New storage placement if store is local (leave blank for default)
--storage, -s="": New storage type: local (default) or minio
--type, -t="": Type of stored files to copy. Allowed types: 'attachments', 'lfs', 'avatars', 'repo-avatars', 'repo-archivers', 'packages', 'actions-log', 'actions-artifacts'
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
dump-repo
Dump the repository from git/github/gitea/gitlab
--auth_password="": The password to visit the clone_addr
--auth_token="": The personal token to visit the clone_addr
--auth_username="": The username to visit the clone_addr
--clone_addr="": The URL will be clone, currently could be a git/github/gitea/gitlab http/https URL
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--git_service="": Git service, git, github, gitea, gitlab. If clone_addr could be recognized, this could be ignored.
--help, -h: show help
--owner_name="": The data will be stored on a directory with owner name if not empty
--repo_dir, -r="": Repository dir path to store the data (default: "./data")
--repo_name="": The data will be stored on a directory with repository name if not empty
--units="": Which items will be migrated, one or more units should be separated as comma. wiki, issues, labels, releases, release_assets, milestones, pull_requests, comments are allowed. Empty means all units.
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
restore-repo
Restore the repository from disk
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--owner_name="": Restore destination owner name
--repo_dir, -r="": Repository dir path to restore from (default: "./data")
--repo_name="": Restore destination repository name
--units="": Which items will be restored, one or more units should be separated as comma. wiki, issues, labels, releases, release_assets, milestones, pull_requests, comments are allowed. Empty means all units.
--validation: Sanity check the content of the files before trying to load them
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
actions
Manage Forgejo Actions
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
generate-runner-token, grt
Generate a new token for a runner to use to register with the server
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--scope, -s="": {owner}[/{repo}] - leave empty for a global runner
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
help, h
Shows a list of commands or help for one command
--config, -c="": Set custom config file (defaults to '{WorkPath}/custom/conf/app.ini') (default: "/etc/forgejo/app.ini")
--custom-path, -C="": Set custom path (defaults to '{WorkPath}/custom')
--help, -h: show help
--work-path, -w="": Set Forgejo's working path (defaults to the directory of the Forgejo binary)
cert
Generate self-signed certificate
--ca: whether this cert should be its own Certificate Authority
--duration="": Duration that certificate is valid for (default: 8760h0m0s)
--ecdsa-curve="": ECDSA curve to use to generate a key. Valid values are P224, P256, P384, P521
--host="": Comma-separated hostnames and IPs to generate a certificate for
--rsa-bits="": Size of RSA key to generate. Ignored if --ecdsa-curve is set (default: 3072)
--start-date="": Creation date formatted as Jan 1 15:04:05 2011
generate
Generate Gitea's secrets/keys/tokens
secret
Generate a secret token
INTERNAL_TOKEN
Generate a new INTERNAL_TOKEN
JWT_SECRET, LFS_JWT_SECRET
Generate a new JWT_SECRET
SECRET_KEY
Generate a new SECRET_KEY
docs
Output CLI documentation
--help, -h: show help
--man: Output man pages instead
--output, -o="": Path to output to instead of stdout (will overwrite if exists)
help, h
Shows a list of commands or help for one command
forgejo-cli
Forgejo CLI
actions
Commands for managing Forgejo Actions
generate-runner-token
Generate a new token for a runner to use to register with the server
--scope, -s="": {owner}[/{repo}] - leave empty for a global runner
generate-secret
Generate a secret suitable for input to the register subcommand
register
Idempotent registration of a runner using a shared secret
--keep-labels: do not affect the labels when updating an existing runner
--labels="": comma separated list of labels supported by the runner (e.g. docker,ubuntu-latest,self-hosted) (not required since v1.21)
--name="": name of the runner (default runner) (default: "runner")
--scope, -s="": {owner}[/{repo}] - leave empty for a global runner
--secret="": the secret the runner will use to connect as a 40 character hexadecimal string
--secret-file="": path to the file containing the secret the runner will use to connect as a 40 character hexadecimal string
--secret-stdin="": the secret the runner will use to connect as a 40 character hexadecimal string, read from stdin
--version="": version of the runner (not required since v1.21)
f3
F3
mirror
Mirror
--from-filesystem-directory="": path to the F3 archive
--from-filesystem-validation: validate the JSON files against F3 JSON schemas
--from-forgejo-password="": PASSWORD of the user
--from-forgejo-token="": TOKEN of the user
--from-forgejo-url="": URL of the forge
--from-forgejo-user="": USER to access the forge API
--from-gitea-password="": PASSWORD of the user
--from-gitea-token="": TOKEN of the user
--from-gitea-url="": URL of the forge
--from-gitea-user="": USER to access the forge API
--from-path="": resource to mirror (e.g. /forge/users/myuser/projects/myproject)
--from-type="": TYPE of the from forge (default: filesystem, allowed values are filesystem,forgejo,gitea,internal_forgejo)
--to-filesystem-directory="": path to the F3 archive
--to-filesystem-validation: validate the JSON files against F3 JSON schemas
--to-forgejo-password="": PASSWORD of the user
--to-forgejo-token="": TOKEN of the user
--to-forgejo-url="": URL of the forge
--to-forgejo-user="": USER to access the forge API
--to-gitea-password="": PASSWORD of the user
--to-gitea-token="": TOKEN of the user
--to-gitea-url="": URL of the forge
--to-gitea-user="": USER to access the forge API
--to-path="": resource to mirror (e.g. /forge/users/myuser/projects/myproject)
--to-type="": TYPE of the to forge (default: filesystem, allowed values are filesystem,forgejo,gitea,internal_forgejo)