Maqtaa/docs/configuration/cheat-sheet.md

aside

aside
false

Configuration Cheat Sheet

YAML Config Key	Environment Variable	Default value	Description
log-level	OG_LOG_LEVEL	warn	Set the log level to one of the following: debug, info, warn, error, fatal.
log-output	OG_LOG_OUTPUT	stdout,file	Set the log output to one or more of the following: stdout, file.
external-url	OG_EXTERNAL_URL	none	Public URL to access to Opengist.
opengist-home	OG_OPENGIST_HOME	home directory	Path to the directory where Opengist stores its data.
secret-key	OG_SECRET_KEY	randomized 32 bytes	Secret key used for session store & encrypt MFA data on database.
db-uri	OG_DB_URI	opengist.db	URI of the database.
index	OG_INDEX	bleve	Define the code indexer (either bleve, meilisearch, or empty for no index).
index.meili.host	OG_MEILI_HOST	none	Set the host for the Meiliseach server.
index.meili.api-key	OG_MEILI_API_KEY	none	Set the API key for the Meiliseach server.
git.default-branch	OG_GIT_DEFAULT_BRANCH	none	Default branch name used by Opengist when initializing Git repositories. If not set, uses the Git default branch name. More info here
sqlite.journal-mode	OG_SQLITE_JOURNAL_MODE	WAL	Set the journal mode for SQLite. More info here
http.host	OG_HTTP_HOST	0.0.0.0	The host on which the HTTP server should bind.
http.port	OG_HTTP_PORT	6157	The port on which the HTTP server should listen.
http.git-enabled	OG_HTTP_GIT_ENABLED	true	Enable or disable git operations (clone, pull, push) via HTTP. (true or false)
metrics.enabled	OG_METRICS_ENABLED	false	Enable or disable Prometheus metrics endpoint at /metrics (true or false)
ssh.git-enabled	OG_SSH_GIT_ENABLED	true	Enable or disable git operations (clone, pull, push) via SSH. (true or false)
ssh.host	OG_SSH_HOST	0.0.0.0	The host on which the SSH server should bind.
ssh.port	OG_SSH_PORT	2222	The port on which the SSH server should listen.
ssh.external-domain	OG_SSH_EXTERNAL_DOMAIN	none	Public domain for the Git SSH connection, if it has to be different from the HTTP one. If not set, uses the URL from the request.
ssh.keygen-executable	OG_SSH_KEYGEN_EXECUTABLE	ssh-keygen	Path to the SSH key generation executable.
github.client-key	OG_GITHUB_CLIENT_KEY	none	The client key for the GitHub OAuth application.
github.secret	OG_GITHUB_SECRET	none	The secret for the GitHub OAuth application.
gitlab.client-key	OG_GITLAB_CLIENT_KEY	none	The client key for the GitLab OAuth application.
gitlab.secret	OG_GITLAB_SECRET	none	The secret for the GitLab OAuth application.
gitlab.url	OG_GITLAB_URL	https://gitlab.com/	The URL of the GitLab instance.
gitlab.name	OG_GITLAB_NAME	GitLab	The name of the GitLab instance. It is displayed in the OAuth login button.
gitea.client-key	OG_GITEA_CLIENT_KEY	none	The client key for the Gitea OAuth application.
gitea.secret	OG_GITEA_SECRET	none	The secret for the Gitea OAuth application.
gitea.url	OG_GITEA_URL	https://gitea.com/	The URL of the Gitea instance.
gitea.name	OG_GITEA_NAME	Gitea	The name of the Gitea instance. It is displayed in the OAuth login button.
oidc.provider-name	OG_OIDC_PROVIDER_NAME	none	The name of the OIDC provider
oidc.client-key	OG_OIDC_CLIENT_KEY	none	The client key for the OpenID application.
oidc.secret	OG_OIDC_SECRET	none	The secret for the OpenID application.
oidc.discovery-url	OG_OIDC_DISCOVERY_URL	none	Discovery endpoint of the OpenID provider.
custom.name	OG_CUSTOM_NAME	none	The name of your instance, to be displayed in the tab title
custom.logo	OG_CUSTOM_LOGO	none	Path to an image, relative to $opengist-home/custom.
custom.favicon	OG_CUSTOM_FAVICON	none	Path to an image, relative to $opengist-home/custom.
custom.static-links	OG_CUSTOM_STATIC_LINK_#_(PATH,NAME)	none	Path and name to custom links, more info here.