InfoGrab DocsInfoGrab Docs

애플리케이션 설정 API

요약

이 API를 사용하여 GitLab 인스턴스의 애플리케이션 설정을 다룹니다. 애플리케이션 설정 변경은 캐시의 영향을 받으므로 즉시 반영되지 않을 수 있습니다. 이 GitLab 인스턴스의 현재 애플리케이션 설정 세부 정보를 조회합니다.

이 API를 사용하여 GitLab 인스턴스의 애플리케이션 설정을 다룹니다.

애플리케이션 설정 변경은 캐시의 영향을 받으므로 즉시 반영되지 않을 수 있습니다. 기본적으로 GitLab은 애플리케이션 설정을 60초 동안 캐시합니다. 인스턴스의 애플리케이션 설정 캐시를 제어하는 방법은 애플리케이션 캐시 간격을 참고합니다.

사전 요구 사항:

  • 인스턴스에 대한 관리자 접근 권한이 있어야 합니다.

현재 애플리케이션 설정의 세부 정보 조회#

히스토리

이 GitLab 인스턴스의 현재 애플리케이션 설정 세부 정보를 조회합니다.

GET /application/settings

curl --request GET \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/application/settings"

응답 예시:

{
  "default_projects_limit" : 100000,
  "signup_enabled" : true,
  "id" : 1,
  "default_branch_protection" : 2,
  "default_branch_protection_defaults": {
        "allowed_to_push": [
            {
                "access_level": 40
            }
        ],
        "allow_force_push": false,
        "allowed_to_merge": [
            {
                "access_level": 40
            }
        ]
    },
  "default_preferred_language" : "en",
  "deletion_adjourned_period": 7,
  "failed_login_attempts_unlock_period_in_minutes": 30,
  "restricted_visibility_levels" : [],
  "sign_in_restrictions": {},
  "password_authentication_enabled_for_web" : true,
  "after_sign_out_path" : null,
  "max_attachment_size" : 100,
  "max_decompressed_archive_size": 25600,
  "max_export_size": 50,
  "max_import_size": 50,
  "max_import_remote_file_size": 10240,
  "max_login_attempts": 3,
  "user_oauth_applications" : true,
  "updated_at" : "2016-01-04T15:44:55.176Z",
  "session_expire_delay" : 10080,
  "home_page_url" : null,
  "default_snippet_visibility" : "private",
  "outbound_local_requests_whitelist": [],
  "domain_allowlist" : [],
  "domain_denylist_enabled" : false,
  "domain_denylist" : [],
  "created_at" : "2016-01-04T15:44:55.176Z",
  "default_ci_config_path" : null,
  "default_project_visibility" : "private",
  "default_group_visibility" : "private",
  "gravatar_enabled" : true,
  "container_expiration_policies_enable_historic_entries": true,
  "container_registry_cleanup_tags_service_max_list_size": 200,
  "container_registry_delete_tags_service_timeout": 250,
  "container_registry_expiration_policies_caching": true,
  "container_registry_expiration_policies_worker_capacity": 4,
  "container_registry_token_expire_delay": 5,
  "oauth_access_token_expires_in": 7200,
  "decompress_archive_file_timeout": 210,
  "repository_storages_weighted": {"default": 100},
  "plantuml_enabled": false,
  "plantuml_url": null,
  "diagramsnet_enabled": true,
  "diagramsnet_url": "https://embed.diagrams.net",
  "kroki_enabled": false,
  "kroki_url": null,
  "terminal_max_session_time": 0,
  "polling_interval_multiplier": 1.0,
  "rsa_key_restriction": 0,
  "dsa_key_restriction": 0,
  "ecdsa_key_restriction": 0,
  "ed25519_key_restriction": 0,
  "ecdsa_sk_key_restriction": 0,
  "ed25519_sk_key_restriction": 0,
  "first_day_of_week": 0,
  "enforce_terms": true,
  "terms": "Hello world!",
  "inactive_resource_access_tokens_delete_after_days": 30,
  "performance_bar_allowed_group_id": 42,
  "user_show_add_ssh_key_message": true,
  "allow_account_deletion": true,
  "updating_name_disabled_for_users": false,
  "local_markdown_version": 0,
  "allow_local_requests_from_hooks_and_services": true,
  "allow_local_requests_from_web_hooks_and_services": true,
  "allow_local_requests_from_system_hooks": false,
  "asset_proxy_enabled": true,
  "asset_proxy_url": "https://assets.example.com",
  "asset_proxy_whitelist": ["example.com", "*.example.com", "your-instance.com"],
  "asset_proxy_allowlist": ["example.com", "*.example.com", "your-instance.com"],
  "maven_package_requests_forwarding": true,
  "npm_package_requests_forwarding": true,
  "pypi_package_requests_forwarding": true,
  "rubygems_package_requests_forwarding": false,
  "snippet_size_limit": 52428800,
  "issues_create_limit": 300,
  "raw_blob_request_limit": 300,
  "raw_blob_request_limit_unauthenticated": 800,
  "wiki_page_max_content_bytes": 5242880,
  "require_admin_approval_after_user_signup": false,
  "require_personal_access_token_expiry": true,
  "personal_access_token_prefix": "glpat-",
  "rate_limiting_response_text": null,
  "keep_latest_artifact": true,
  "admin_mode": false,
  "floc_enabled": false,
  "external_pipeline_validation_service_timeout": null,
  "external_pipeline_validation_service_token": null,
  "external_pipeline_validation_service_url": null,
  "jira_connect_application_key": null,
  "jira_connect_public_key_storage_enabled": false,
  "jira_connect_proxy_url": null,
  "jira_connect_additional_audience_url": null,
  "silent_mode_enabled": false,
  "package_registry_allow_anyone_to_pull_option": true,
  "bulk_import_max_download_file_size": 5120,
  "project_jobs_api_rate_limit": 600,
  "runner_jobs_request_api_limit": 2000,
  "runner_jobs_patch_trace_api_limit": 200,
  "runner_jobs_endpoints_api_limit": 200,
  "security_txt_content": null,
  "security_scan_stale_after_days": 90,
  "bulk_import_concurrent_pipeline_batch_limit": 25,
  "concurrent_relation_batch_export_limit": 25,
  "concurrent_relation_export_limit": 25,
  "relation_export_batch_size": 50,
  "concurrent_github_import_jobs_limit": 1000,
  "concurrent_bitbucket_import_jobs_limit": 100,
  "concurrent_bitbucket_server_import_jobs_limit": 100,
  "concurrent_pull_request_import_jobs_limit": 200,
  "import_jobs_concurrency_limit": 100,
  "silent_admin_exports_enabled": false,
  "top_level_group_creation_enabled": true,
  "disable_invite_members": false,
  "enforce_pipl_compliance": true,
  "model_prompt_cache_enabled": true,
  "lock_model_prompt_cache_enabled": false
}

GitLab Premium 또는 Ultimate 사용자는 다음 파라미터도 확인할 수 있습니다.

  • allow_all_integrations
  • allowed_integrations
  • audit_events_api_limit
  • default_project_deletion_protection
  • delete_unconfirmed_users
  • dependency_scanning_sbom_scan_api_download_limit
  • dependency_scanning_sbom_scan_api_upload_limit
  • disable_personal_access_tokens
  • duo_features_enabled
  • elasticsearch_index_settings
  • file_template_project_id
  • geo_node_allowed_ips
  • geo_status_timeout
  • group_owners_can_manage_default_branch_protection
  • lock_duo_features_enabled
  • scan_execution_policies_action_limit
  • scan_execution_policies_schedule_limit
  • secret_push_protection_available
  • security_approval_policies_limit
  • security_policy_global_group_approvers_enabled
  • unconfirmed_users_delete_after_days
  • use_clickhouse_for_analytics
  • virtual_registries_endpoints_api_limit
  • project_secrets_limit
  • group_secrets_limit
  • security_mr_report_cache_lifetime_minutes
  • security_scan_stale_after_days
  • service_access_tokens_expiration_enforced
{
  "allow_all_integrations": true,
  "allowed_integrations": [],
  "default_project_deletion_protection": false,
  "disable_personal_access_tokens": false,
  "duo_features_enabled": true,
  "elasticsearch_index_settings": [
    {
      "alias_name": "gitlab-production",
      "number_of_shards": 5,
      "number_of_replicas": 1
    }
  ],
  "file_template_project_id": 1,
  "geo_node_allowed_ips": "0.0.0.0/0, ::/0",
  "group_owners_can_manage_default_branch_protection": true,
  "id": 1,
  "lock_duo_features_enabled": false,
  "signup_enabled": true,
  "virtual_registries_endpoints_api_limit": 4000,
  "project_secrets_limit": 100,
  "group_secrets_limit": 500
  ...
}

애플리케이션 설정 업데이트#

히스토리
  • GitLab 17.0에서 default_branch_protection 이 사용 중단되었습니다. 대신 default_branch_protection_defaults를 사용합니다.
  • GitLab 17.0에서 throttle_unauthenticated_git_http_enabled, throttle_unauthenticated_git_http_period_in_seconds, throttle_unauthenticated_git_http_requests_per_period 속성이 추가되었습니다.
  • GitLab 17.6에서 allow_all_integrations 및 allowed_integrations 속성이 추가되었습니다.
  • GitLab 18.1에서 throttle_authenticated_git_http_enabled, throttle_authenticated_git_http_period_in_seconds, throttle_authenticated_git_http_requests_per_period 속성이 git_authenticated_http_limit라는 기능 플래그와 함께 추가되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 18.3에서 git_authenticated_http_limit 기능 플래그가 활성화되었습니다.
  • GitLab 18.4에서 git_authenticated_http_limit 기능 플래그가 제거되었습니다.
  • GitLab 19.4에서 throttle_authenticated_dependency_proxy_enabled, throttle_authenticated_dependency_proxy_period_in_seconds, throttle_authenticated_dependency_proxy_requests_per_period 속성이 추가되었습니다.

이 GitLab 인스턴스의 현재 애플리케이션 설정을 업데이트합니다.

PUT /application/settings

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/application/settings" \
  --data "signup_enabled=false" \
  --data "default_project_visibility=internal"

응답 예시:

{
  "id": 1,
  "default_projects_limit": 100000,
  "default_preferred_language": "en",
  "failed_login_attempts_unlock_period_in_minutes": 30,
  "signup_enabled": false,
  "password_authentication_enabled_for_web": true,
  "gravatar_enabled": true,
  "created_at": "2015-06-12T15:51:55.432Z",
  "updated_at": "2015-06-30T13:22:42.210Z",
  "home_page_url": "",
  "default_branch_protection": 2,
  "default_branch_protection_defaults": {
    "allowed_to_push": [
        {
            "access_level": 40
        }
    ],
    "allow_force_push": false,
    "allowed_to_merge": [
        {
            "access_level": 40
        }
    ]
  },
  "restricted_visibility_levels": [],
  "sign_in_restrictions": {},
  "max_attachment_size": 100,
  "max_decompressed_archive_size": 25600,
  "max_export_size": 50,
  "max_import_size": 50,
  "max_import_remote_file_size": 10240,
  "max_login_attempts": 3,
  "session_expire_delay": 10080,
  "default_ci_config_path" : null,
  "default_project_visibility": "internal",
  "default_snippet_visibility": "private",
  "default_group_visibility": "private",
  "outbound_local_requests_whitelist": [],
  "domain_allowlist": [],
  "domain_denylist_enabled" : false,
  "domain_denylist" : [],
  "external_authorization_service_enabled": true,
  "external_authorization_service_url": "https://authorize.me",
  "external_authorization_service_default_label": "default",
  "external_authorization_service_timeout": 0.5,
  "user_oauth_applications": true,
  "after_sign_out_path": "",
  "container_expiration_policies_enable_historic_entries": true,
  "container_registry_cleanup_tags_service_max_list_size": 200,
  "container_registry_delete_tags_service_timeout": 250,
  "container_registry_expiration_policies_caching": true,
  "container_registry_expiration_policies_worker_capacity": 4,
  "container_registry_token_expire_delay": 5,
  "oauth_access_token_expires_in": 7200,
  "decompress_archive_file_timeout": 210,
  "package_registry_cleanup_policies_worker_capacity": 2,
  "plantuml_enabled": false,
  "plantuml_url": null,
  "diagramsnet_enabled": true,
  "diagramsnet_url": "https://embed.diagrams.net",
  "terminal_max_session_time": 0,
  "polling_interval_multiplier": 1.0,
  "rsa_key_restriction": 0,
  "dsa_key_restriction": 0,
  "ecdsa_key_restriction": 0,
  "ed25519_key_restriction": 0,
  "ecdsa_sk_key_restriction": 0,
  "ed25519_sk_key_restriction": 0,
  "first_day_of_week": 0,
  "enforce_terms": true,
  "terms": "Hello world!",
  "inactive_resource_access_tokens_delete_after_days": 30,
  "performance_bar_allowed_group_id": 42,
  "user_show_add_ssh_key_message": true,
  "file_template_project_id": 1,
  "local_markdown_version": 0,
  "asset_proxy_enabled": true,
  "asset_proxy_url": "https://assets.example.com",
  "asset_proxy_allowlist": ["example.com", "*.example.com", "your-instance.com"],
  "globally_allowed_ips": "",
  "geo_node_allowed_ips": "0.0.0.0/0, ::/0",
  "allow_local_requests_from_hooks_and_services": true,
  "allow_local_requests_from_web_hooks_and_services": true,
  "allow_local_requests_from_system_hooks": false,
  "maven_package_requests_forwarding": true,
  "npm_package_requests_forwarding": true,
  "pypi_package_requests_forwarding": true,
  "rubygems_package_requests_forwarding": false,
  "snippet_size_limit": 52428800,
  "issues_create_limit": 300,
  "raw_blob_request_limit": 300,
  "raw_blob_request_limit_unauthenticated": 800,
  "wiki_page_max_content_bytes": 5242880,
  "require_admin_approval_after_user_signup": false,
  "require_personal_access_token_expiry": true,
  "personal_access_token_prefix": "glpat-",
  "rate_limiting_response_text": null,
  "keep_latest_artifact": true,
  "admin_mode": false,
  "external_pipeline_validation_service_timeout": null,
  "external_pipeline_validation_service_token": null,
  "external_pipeline_validation_service_url": null,
  "can_create_group": false,
  "jira_connect_application_key": "123",
  "jira_connect_public_key_storage_enabled": true,
  "jira_connect_proxy_url": "http://gitlab.example.com",
  "user_defaults_to_private_profile": true,
  "projects_api_rate_limit_unauthenticated": 400,
  "runner_jobs_request_api_limit": 2000,
  "runner_jobs_patch_trace_api_limit": 200,
  "runner_jobs_endpoints_api_limit": 200,
  "users_api_limit_followers": 100,
  "users_api_limit_following": 100,
  "users_api_limit_status": 240,
  "users_api_limit_ssh_keys": 120,
  "users_api_limit_ssh_key": 120,
  "users_api_limit_gpg_keys": 120,
  "users_api_limit_gpg_key": 120,
  "web_hook_event_resend_limit": 5,
  "web_hook_test_limit": 5,
  "silent_mode_enabled": false,
  "security_policy_global_group_approvers_enabled": true,
  "security_approval_policies_limit": 5,
  "scan_execution_policies_action_limit": 0,
  "scan_execution_policies_schedule_limit": 0,
  "package_registry_allow_anyone_to_pull_option": true,
  "bulk_import_max_download_file_size": 5120,
  "project_jobs_api_rate_limit": 600,
  "security_txt_content": null,
  "security_scan_stale_after_days": 90,
  "bulk_import_concurrent_pipeline_batch_limit": 25,
  "concurrent_relation_batch_export_limit": 25,
  "concurrent_relation_export_limit": 25,
  "relation_export_batch_size": 50,
  "downstream_pipeline_trigger_limit_per_project_user_sha": 0,
  "concurrent_github_import_jobs_limit": 1000,
  "concurrent_bitbucket_import_jobs_limit": 100,
  "concurrent_bitbucket_server_import_jobs_limit": 100,
  "concurrent_pull_request_import_jobs_limit": 200,
  "import_jobs_concurrency_limit": 100,
  "silent_admin_exports_enabled": false,
  "enforce_pipl_compliance": true
}

GitLab Premium 또는 Ultimate 사용자는 다음 파라미터도 확인할 수 있습니다.

  • allow_all_integrations
  • allowed_integrations
  • audit_events_api_limit
  • group_owners_can_manage_default_branch_protection
  • file_template_project_id
  • geo_node_allowed_ips
  • geo_status_timeout
  • default_project_deletion_protection
  • disable_personal_access_tokens
  • security_policy_global_group_approvers_enabled
  • security_approval_policies_limit
  • scan_execution_policies_action_limit
  • scan_execution_policies_schedule_limit
  • delete_unconfirmed_users
  • unconfirmed_users_delete_after_days
  • duo_features_enabled
  • lock_duo_features_enabled
  • use_clickhouse_for_analytics
  • virtual_registries_endpoints_api_limit
  • lock_memberships_to_saml
  • security_mr_report_cache_lifetime_minutes
  • security_scan_stale_after_days
  • service_access_tokens_expiration_enforced

응답 예시:

  "file_template_project_id": 1,
  "geo_node_allowed_ips": "0.0.0.0/0, ::/0",
  "duo_features_enabled": true,
  "lock_duo_features_enabled": false,
  "allow_all_integrations": true,
  "allowed_integrations": [],
  "virtual_registries_endpoints_api_limit": 4000

사용 가능한 설정#

히스토리
  • GitLab 17.0에서 silent_admin_exports_enabled가 도입되었습니다.
  • GitLab 17.2에서 ai_action_api_rate_limit가 도입되었습니다.
  • GitLab 17.3에서 require_personal_access_token_expiry가 도입되었습니다.
  • GitLab 17.4에서 receptive_cluster_agents_enabled가 도입되었습니다.
  • GitLab 17.6에서 allow_all_integrations와 allowed_integrations가 추가되었습니다.
  • GitLab 18.6에서 iframe_rendering_enabled, iframe_rendering_allowlist, iframe_rendering_allowlist_raw가 도입되었습니다.
  • GitLab 19.0에서 built_in_project_templates_enabled와 lock_built_in_project_templates_enabled가 use_built_in_project_templates_enabled라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 19.1에서 email_otp_enabled가 도입되었습니다.
  • GitLab 19.2에서 built_in_project_templates_enabled와 lock_built_in_project_templates_enabled가 일반 공급되었습니다. 기능 플래그 use_built_in_project_templates_enabled는 제거되었습니다.
  • GitLab 19.2에서 require_sha_for_merge와 lock_require_sha_for_merge가 도입되었습니다.
  • GitLab 19.2에서 sidekiq_timezone_override가 도입되었습니다.
  • GitLab 19.4에서 concurrent_pull_request_import_jobs_limit가 도입되어, Bitbucket Server(50)와 GitHub(200) 임포터에 하드코딩되어 있던 제한을 기본값 200으로 통일했습니다.
  • GitLab 19.4에서 tags_create_limit가 도입되었습니다.
  • GitLab 19.4에서 audit_events_api_limit가 도입되었습니다.
  • GitLab 19.4에서 block_jwt_for_reclaimed_paths가 도입되었습니다.

일반적으로 모든 설정은 선택 사항입니다. 일부 설정을 활성화할 때는 관련된 다른 설정도 함께 구성해야 할 수 있습니다. 이러한 요구 사항은 아래 표의 Required(필수) 칼럼에 정리되어 있습니다.

속성 유형 필수 설명
admin_mode boolean no 관리 작업 시 재인증을 통해 관리자가 Admin Mode를 활성화하도록 요구합니다.
admin_notification_email string no 사용 중단: 대신 abuse_notification_email을 사용합니다. 설정하면 악용 신고가 이 주소로 전송됩니다. 악용 신고는 Admin 영역에서 항상 확인할 수 있습니다.
abuse_notification_email string no 설정하면 악용 신고가 이 주소로 전송됩니다. 악용 신고는 Admin 영역에서 항상 확인할 수 있습니다.
notify_on_unknown_sign_in boolean no 알 수 없는 IP 주소에서 로그인이 발생하면 알림을 전송합니다.
after_sign_out_path string no 로그아웃 후 사용자를 리디렉션할 위치입니다.
email_restrictions_enabled boolean no 새 사용자가 이메일로 계정을 생성하지 못하도록 차단합니다.
email_restrictions string required by: email_restrictions_enabled 가입 시 사용된 이메일을 검사하는 정규 표현식입니다.
after_sign_up_text string no 가입 후 사용자에게 표시되는 텍스트입니다.
ai_action_api_rate_limit integer no 사용자당 8시간마다 aiAction GraphQL 뮤테이션에 허용되는 최대 요청 수입니다. 기본값: 160. 속도 제한을 해제하려면 0으로 설정합니다.
akismet_api_key string required by: akismet_enabled Akismet 스팸 방지용 API 키입니다.
akismet_enabled boolean no (활성화 시 필요: akismet_api_key) Akismet 스팸 방지를 활성화하거나 비활성화합니다.
allow_all_integrations boolean no false 이면 allowed_integrations에 있는 통합만 인스턴스에서 허용됩니다. Ultimate 전용입니다.
allowed_integrations array of strings no allow_all_integrations가 false 이면 이 목록에 있는 통합만 인스턴스에서 허용됩니다. Ultimate 전용입니다.
allow_account_deletion boolean no 사용자가 자신의 계정을 삭제할 수 있도록 허용하려면 true로 설정합니다. Premium 및 Ultimate 전용입니다.
allow_group_owners_to_manage_ldap boolean no 그룹 Owner가 LDAP를 관리할 수 있도록 허용하려면 true로 설정합니다. Premium 및 Ultimate 전용입니다.
allow_local_requests_from_hooks_and_services boolean no (사용 중단: 대신 allow_local_requests_from_web_hooks_and_services를 사용합니다) 웹훅과 통합에서 로컬 네트워크로의 요청을 허용합니다.
allow_local_requests_from_system_hooks boolean no 시스템 훅에서 로컬 네트워크로의 요청을 허용합니다.
allow_local_requests_from_web_hooks_and_services boolean no 웹훅과 통합에서 로컬 네트워크로의 요청을 허용합니다.
allow_project_creation_for_guest_and_below boolean no Guest 권한 이하가 할당된 사용자가 그룹과 개인 프로젝트를 생성할 수 있는지 여부입니다. 기본값은 true 입니다.
allow_runner_registration_token boolean no 등록 토큰으로 러너를 생성하도록 허용합니다. 기본값은 true 입니다.
archive_builds_in_human_readable string no job을 오래된 것으로 간주해 만료 처리할 기간을 설정합니다. 이 기간이 지나면 job은 아카이브되어 다시 실행할 수 없습니다. job을 만료하지 않으려면 비워 둡니다. 1일 이상이어야 하며, 예를 들어 15 days, 1 month, 2 years와 같이 지정합니다.
asset_proxy_enabled boolean no (활성화 시 필요: asset_proxy_url) 에셋 프록시를 활성화합니다. 변경 사항을 적용하려면 GitLab을 재시작해야 합니다.
asset_proxy_secret_key string no 에셋 프록시 서버와 공유하는 시크릿입니다. 변경 사항을 적용하려면 GitLab을 재시작해야 합니다.
asset_proxy_url string no 에셋 프록시 서버의 URL 입니다. 변경 사항을 적용하려면 GitLab을 재시작해야 합니다.
asset_proxy_whitelist string or array of strings no (사용 중단: 대신 asset_proxy_allowlist를 사용합니다) 이 도메인과 일치하는 에셋은 프록시를 거치지 않습니다. 와일드카드를 사용할 수 있습니다. 설치한 GitLab의 URL은 자동으로 허용 목록에 포함됩니다. 변경 사항을 적용하려면 GitLab을 재시작해야 합니다.
asset_proxy_allowlist string or array of strings no 이 도메인과 일치하는 에셋은 프록시를 거치지 않습니다. 와일드카드를 사용할 수 있습니다. 설치한 GitLab의 URL은 자동으로 허용 목록에 포함됩니다. 변경 사항을 적용하려면 GitLab을 재시작해야 합니다.
audit_events_api_limit integer no 사용자당 1분간 인스턴스 감사 이벤트 API에 허용되는 최대 요청 수입니다. 기본값: 200. 속도 제한을 해제하려면 0으로 설정합니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. GitLab 19.4에서 도입되었습니다.
authn_data_retention_cleanup_enabled boolean no true 이면 1년이 지난 인증 로그인 기록과, 한 달이 지난 폐기된 OAuth 액세스 토큰 및 권한 부여를 영구 삭제하는 정리 워커를 실행합니다. 기본값: false. GitLab 18.7에서 도입되었습니다.
authorized_keys_enabled boolean no 기본적으로 authorized_keys 파일은 추가 설정 없이 SSH 기반 Git을 지원합니다. GitLab은 데이터베이스 파일로 SSH 키를 인증하도록 최적화할 수 있습니다. OpenSSH 서버에 AuthorizedKeysCommand를 설정한 경우에만 이 설정을 비활성화합니다.
auto_accept_awarded_achievements boolean no true 이면 새로 부여된 업적이 자동으로 수락되어 사용자 프로필에 즉시 표시됩니다. 이 설정을 활성화하기 전에 부여된 업적에는 영향을 주지 않습니다. 수신자는 업적을 숨길 수 있습니다. 기본값: false. GitLab 19.4에서 도입되었습니다.
auto_devops_domain string no 모든 프로젝트의 Auto Review Apps 및 Auto Deploy Stage에서 기본으로 사용할 도메인을 지정합니다.
auto_devops_enabled boolean no 프로젝트에 Auto DevOps를 기본으로 활성화합니다. 사전 정의된 CI/CD 구성을 기준으로 애플리케이션을 자동으로 빌드, 테스트, 배포합니다.
autocomplete_users integer no GET /autocomplete/users 엔드포인트에 대한 분당 최대 인증 요청 수입니다.
autocomplete_users_unauthenticated integer no GET /autocomplete/users 엔드포인트에 대한 분당 최대 비인증 요청 수입니다.
automatic_purchased_storage_allocation boolean no 활성화하면 네임스페이스에서 구매한 스토리지가 자동으로 할당됩니다. EE 배포판에만 해당합니다.
bulk_import_enabled boolean no 직접 전송 방식의 GitLab 그룹 마이그레이션을 활성화합니다. 이 설정은 Admin 영역에서도 사용할 수 있습니다.
offline_transfer_exports_enabled boolean no 오프라인 전송 방식으로 GitLab 그룹과 프로젝트를 내보낼 수 있도록 활성화합니다. GitLab 19.3에서 도입되었습니다.
offline_transfer_imports_enabled boolean no 오프라인 전송 방식으로 GitLab 그룹과 프로젝트를 가져올 수 있도록 활성화합니다. GitLab 19.3에서 도입되었습니다.
bulk_import_max_download_file_size integer no 직접 전송 방식으로 소스 GitLab 인스턴스에서 가져올 때의 최대 다운로드 파일 크기입니다.
allow_bypass_placeholder_confirmation boolean no 관리자가 플레이스홀더 사용자를 재할당할 때 확인 절차를 건너뜁니다. GitLab 18.0에서 도입되었습니다.
allow_s3_compatible_storage_for_offline_transfer boolean no 오프라인 전송에 S3 호환 오브젝트 스토리지를 허용합니다. GitLab 18.9에서 도입되었습니다.
allow_application_default_credentials_for_offline_transfer boolean no 오프라인 전송에 Google Cloud Application Default Credentials를 허용합니다. 활성화하더라도 관리자만 이 자격 증명을 사용할 수 있으며, 버킷 이름은 gitlab-offline-transfer-로 시작해야 합니다. GitLab.com에는 영향을 주지 않습니다. 자세한 내용은 오프라인 전송에 애플리케이션 기본 자격 증명 허용을 참고합니다. GitLab 19.3에서 도입되었습니다.
built_in_project_templates_enabled boolean no 사용자가 프로젝트를 생성할 때 기본 제공 프로젝트 템플릿을 사용할 수 있도록 활성화합니다. Premium 및 Ultimate 전용입니다. GitLab 19.0에서 use_built_in_project_templates_enabled라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. GitLab 19.2에서 일반 공급되었습니다. 기능 플래그 use_built_in_project_templates_enabled는 제거되었습니다.
lock_built_in_project_templates_enabled boolean no 모든 그룹에 built_in_project_templates_enabled 설정을 강제합니다. Premium 및 Ultimate 전용입니다. GitLab 19.0에서 use_built_in_project_templates_enabled라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. GitLab 19.2에서 일반 공급되었습니다. 기능 플래그 use_built_in_project_templates_enabled는 제거되었습니다.
can_create_group boolean no 사용자가 최상위 그룹을 생성할 수 있는지 여부입니다. 기본값은 true 입니다.
check_namespace_plan boolean no 활성화하면 프로젝트 네임스페이스의 플랜에 해당 기능이 포함되어 있거나 프로젝트가 공개인 경우에만 라이선스가 있는 EE 기능을 사용할 수 있습니다. Premium 및 Ultimate 전용입니다.
ci_delete_pipelines_in_seconds_limit_human_readable string no 파이프라인 보존 기간에 설정할 수 있는 최댓값입니다. 기본값은 1 year 입니다.
ci_job_live_trace_enabled boolean no job 로그의 증분 로깅을 켭니다. 켜면 아카이브된 job 로그가 오브젝트 스토리지에 증분 방식으로 업로드됩니다. 오브젝트 스토리지를 먼저 구성해야 합니다. 이 설정은 Admin 영역에서도 구성할 수 있습니다.
git_push_pipeline_limit integer no 한 번의 Git 푸시로 트리거할 수 있는 태그 또는 브랜치 파이프라인의 최대 개수를 설정합니다. 이 제한에 대한 자세한 내용은 Git 푸시당 파이프라인 수를 참고합니다.
ci_max_total_yaml_size_bytes integer no 포함된 모든 YAML 구성 파일을 합쳐 파이프라인 구성에 할당할 수 있는 최대 메모리 크기(바이트)입니다.
ci_max_includes integer no 파이프라인당 최대 include 개수입니다. 기본값은 150 입니다.
ci_partitions_size_limit integer no 새 파티션을 생성하기 전에 CI 테이블의 데이터베이스 파티션이 사용할 수 있는 최대 디스크 공간(바이트)입니다. 기본값은 100 GB 입니다. GitLab 18.11에서 제거되었습니다.
ci_partitions_in_seconds_limit_human_readable string no 새 CI 파티션을 생성하고 다음 파티션 집합으로 전환하기까지의 기간입니다. 1 month에서 6 months 사이여야 합니다. 기본값은 1 month 입니다.
ci_partitions_in_seconds_limit integer no 새 CI 파티션을 생성하고 다음 파티션 집합으로 전환하기까지의 기간(초)입니다. 1개월에서 6개월 사이여야 합니다. 기본값은 1개월(2592000)입니다. 쓰기 전용이며 GET 응답에는 반환되지 않습니다. ci_partitions_in_seconds_limit_human_readable로 대체되어 사용 중단되었으며 API v5에서 제거될 예정입니다.
code_dropdown_custom_clients array of hashes no 프로젝트의 Code 드롭다운 목록에 표시되는 사용자 지정 "Open with" 클라이언트입니다. 각 항목에는 name과, {url}을 정확히 한 번 포함하는 ssh_url_template 또는 http_url_template 중 하나 이상이 있어야 합니다. custom_code_dropdown_clients 기능 플래그가 활성화된 경우에만 사용할 수 있습니다.
concurrent_github_import_jobs_limit integer no GitHub 임포터의 최대 동시 가져오기 job 수입니다. 기본값은 1000 입니다.
concurrent_bitbucket_import_jobs_limit integer no Bitbucket Cloud 임포터의 최대 동시 가져오기 job 수입니다. 기본값은 100 입니다.
concurrent_bitbucket_server_import_jobs_limit integer no Bitbucket Server 임포터의 최대 동시 가져오기 job 수입니다. 기본값은 100 입니다.
concurrent_pull_request_import_jobs_limit integer no GitHub, Bitbucket Cloud, Bitbucket Server 임포터의 최대 동시 풀 리퀘스트 가져오기 job 수입니다. 기본값은 200 입니다.
import_jobs_concurrency_limit integer no 가져오기 워커 유형별(프로젝트 및 그룹 파일 기반 가져오기, 직접 전송, GitHub·Bitbucket Cloud·Bitbucket Server 임포터 Stage)로 동시에 실행할 수 있는 최대 job 수입니다. 워커 유형마다 따로 적용됩니다. 기본값은 100 입니다. GitLab 19.1에서 도입되었습니다.
commit_email_hostname string no 커스텀 호스트 이름입니다(비공개 커밋 이메일용).
container_expiration_policies_enable_historic_entries boolean no 모든 프로젝트에 정리 정책을 활성화합니다.
container_registry_cleanup_tags_service_max_list_size integer no 정리 정책을 한 번 실행할 때 삭제할 수 있는 최대 태그 수입니다.
container_registry_delete_tags_service_timeout integer no 정리 정책에서 태그 한 묶음을 삭제하는 데 허용되는 최대 시간(초)입니다.
container_registry_expiration_policies_caching boolean no 정리 정책 실행 중 캐시 사용 여부입니다.
container_registry_expiration_policies_worker_capacity integer no 정리 정책에 사용할 워커 수입니다.
container_registry_token_expire_delay integer no 컨테이너 레지스트리 토큰의 유효 기간(분)입니다.
package_registry_cleanup_policies_worker_capacity integer no 패키지 정리 정책에 할당되는 워커 수입니다.
updating_name_disabled_for_users boolean no 사용자 프로필 이름 변경을 비활성화합니다.
deactivate_dormant_users boolean no 휴면 사용자 자동 비활성화를 활성화합니다.
deactivate_dormant_users_period integer no 사용자를 휴면으로 간주하기까지의 기간(일)입니다.
decompress_archive_file_timeout integer no 아카이브 파일 압축 해제의 기본 타임아웃(초)입니다. 타임아웃을 해제하려면 0으로 설정합니다.
default_artifacts_expire_in string no 각 job 아티팩트의 기본 만료 시간을 설정합니다.
default_branch_name string no 인스턴스의 모든 프로젝트에 대해 초기 브랜치 이름을 설정합니다.
default_branch_protection integer no GitLab 17.0에서 사용 중단되었습니다. 대신 default_branch_protection_defaults를 사용합니다.
default_branch_protection_defaults hash no GitLab 17.0에서 도입되었습니다. 사용할 수 있는 옵션은 default_branch_protection_defaults 옵션을 참고합니다.
default_ci_config_path string no 새 프로젝트의 기본 CI/CD 구성 파일과 경로입니다(설정하지 않으면 .gitlab-ci.yml).
default_group_visibility string no 새 그룹에 적용되는 공개 범위입니다. private, internal, public을 파라미터로 받을 수 있습니다. 기본값은 private 입니다. restricted_visibility_levels에 지정된 수준으로는 설정할 수 없습니다.
default_preferred_language string no 로그인하지 않은 사용자의 기본 선호 언어입니다.
default_project_creation integer no 프로젝트 생성에 필요한 기본 최소 권한입니다. 0 (No one), 1 (Maintainers), 2 (Developers), 3 (Administrators), 4 (Owners) 중 하나를 받을 수 있습니다.
default_project_visibility string no 새 프로젝트에 적용되는 공개 범위입니다. private, internal, public을 파라미터로 받을 수 있습니다. 기본값은 private 입니다. restricted_visibility_levels에 지정된 수준으로는 설정할 수 없습니다.
default_projects_limit integer no 사용자당 프로젝트 제한입니다. 기본값은 100000 입니다.
default_snippet_visibility string no 새 스니펫에 적용되는 공개 범위입니다. private, internal, public을 파라미터로 받을 수 있습니다. 기본값은 private 입니다.
default_syntax_highlighting_theme integer no 신규 사용자와 로그인하지 않은 사용자에게 적용되는 기본 구문 강조 테마입니다. 사용할 수 있는 테마의 ID를 참고합니다.
default_dark_syntax_highlighting_theme integer no 신규 사용자와 로그인하지 않은 사용자에게 적용되는 다크 모드 기본 구문 강조 테마입니다. 사용할 수 있는 테마의 ID를 참고합니다.
default_project_deletion_protection boolean no 기본 프로젝트 삭제 보호를 활성화하여 관리자만 프로젝트를 삭제할 수 있게 합니다. 기본값은 false 입니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
delete_unconfirmed_users boolean no 이메일을 확인하지 않은 사용자를 삭제할지 여부를 지정합니다. 기본값은 false 입니다. true로 설정하면 미확인 사용자는 unconfirmed_users_delete_after_days 일 후에 삭제됩니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
deletion_adjourned_period integer no 삭제 예정으로 표시된 프로젝트 또는 그룹을 삭제하기까지 대기하는 일수입니다. 값은 1에서 90 사이여야 합니다. 기본값은 30 입니다.
dependency_management_settings hash no 의존성 관리 설정입니다. Sidekiq 전체에서 동시에 실행되는 보안 업데이트 스케줄러 job 수를 제한하려면 security_update_scheduler_max_concurrency(정수)를 설정합니다. 기본값: 30. 상한은 200 입니다. 스케줄링을 일시 중지하려면 0으로 설정합니다. Ultimate 전용입니다. GitLab 19.1에서 도입되었습니다.
description_and_note_max_size integer no 작업 항목, 머지 리퀘스트, 취약점의 설명 및 댓글 내용의 최대 크기(바이트)입니다. 기본값은 1048576 입니다.
diagramsnet_enabled boolean no (활성화하려면 diagramsnet_url 이 필요합니다) Diagrams.net 통합을 활성화합니다. 기본값은 true 입니다.
diagramsnet_url string required by: diagramsnet_enabled 통합에 사용할 Diagrams.net 인스턴스 URL 입니다.
diff_max_patch_bytes integer no 최대 diff 패치 크기(바이트)입니다.
diff_max_files integer no diff의 최대 파일 수입니다.
diff_max_lines integer no diff의 최대 줄 수입니다.
diff_max_versions integer no 머지 리퀘스트당 최대 diff 버전 수입니다.
diff_max_commits integer no 머지 리퀘스트당 최대 diff 커밋 수입니다.
disable_admin_oauth_scopes boolean no 관리자가 api, read_api, read_repository, write_repository, read_registry, write_registry, sudo 스코프를 가진 신뢰되지 않은 OAuth 2.0 애플리케이션에 GitLab 계정을 연결하지 못하도록 막습니다.
disable_feed_token boolean no RSS/Atom 및 캘린더 피드 토큰 표시를 비활성화합니다.
disable_personal_access_tokens boolean no 개인 액세스 토큰을 비활성화합니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. API를 통해 비활성화한 개인 액세스 토큰을 다시 활성화하는 방법은 없습니다. 이는 알려진 이슈입니다. 사용할 수 있는 우회 방법은 우회 방법을 참고합니다.
block_jwt_for_reclaimed_paths boolean no 이전에 사용된 네임스페이스 경로를 다시 확보한 프로젝트에 대해 CI/CD JWT 및 OIDC 토큰 생성을 차단합니다. 기본값은 true(제한 활성화)입니다. 네임스페이스 재확보로 인한 인증 우회 위험을 이해하고 감수하는 경우에만 비활성화합니다. GitLab Self-Managed 및 GitLab Dedicated 전용입니다.
disabled_oauth_sign_in_sources array of strings no 비활성화된 OAuth 로그인 소스입니다.
disable_password_authentication_for_users_with_sso_identities boolean no SSO ID가 있는 사용자에 대해 웹 인터페이스의 비밀번호 인증을 비활성화합니다. HTTP(S) 기반 Git 작업에는 영향을 주지 않습니다. 기본값은 false 입니다.
dns_rebinding_protection_enabled boolean no DNS 리바인딩 공격 방어를 강제합니다.
domain_denylist_enabled boolean no (활성화 시 필요: domain_denylist) 특정 도메인 이메일로 새 사용자 계정이 생성되는 것을 차단합니다.
domain_denylist array of strings no 이 도메인과 일치하는 이메일 주소를 가진 사용자는 새 계정을 만들 수 없습니다. 와일드카드를 사용할 수 있습니다. 여러 항목은 줄을 나누어 입력합니다. 예를 들어 domain.com, *.domain.com과 같이 지정합니다.
domain_allowlist array of strings no 계정 생성 시 회사 이메일만 사용하도록 강제합니다. 기본값은 null 이며 제한이 없음을 의미합니다.
downstream_pipeline_trigger_limit_per_project_user_sha integer no 최대 다운스트림 파이프라인 트리거 속도입니다. 기본값: 0(제한 없음).
dsa_key_restriction integer no 업로드할 수 있는 DSA 키의 최소 비트 길이입니다. 기본값은 0(제한 없음)입니다. -1은 DSA 키를 비활성화합니다.
ecdsa_key_restriction integer no 업로드할 수 있는 ECDSA 키의 최소 커브 크기(비트)입니다. 기본값은 0(제한 없음)입니다. -1은 ECDSA 키를 비활성화합니다.
ecdsa_sk_key_restriction integer no 업로드할 수 있는 ECDSA_SK 키의 최소 커브 크기(비트)입니다. 기본값은 0(제한 없음)입니다. -1은 ECDSA_SK 키를 비활성화합니다.
ed25519_key_restriction integer no 업로드할 수 있는 ED25519 키의 최소 커브 크기(비트)입니다. 기본값은 0(제한 없음)입니다. -1은 ED25519 키를 비활성화합니다.
ed25519_sk_key_restriction integer no 업로드할 수 있는 ED25519_SK 키의 최소 커브 크기(비트)입니다. 기본값은 0(제한 없음)입니다. -1은 ED25519_SK 키를 비활성화합니다.
eks_access_key_id string no AWS IAM 액세스 키 ID 입니다.
eks_account_id string no Amazon 계정 ID 입니다.
eks_integration_enabled boolean no Amazon EKS 통합을 활성화합니다.
eks_secret_access_key string no AWS IAM 시크릿 액세스 키입니다.
elasticsearch_aws_access_key string no AWS IAM 액세스 키입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_aws_region string no Elasticsearch 도메인이 구성된 AWS 리전입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_aws_secret_access_key string no AWS IAM 시크릿 액세스 키입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_aws boolean no AWS 호스팅 Elasticsearch 사용을 활성화합니다. Premium 및 Ultimate 전용입니다.
elasticsearch_client_adapter string no Elasticsearch Ruby 클라이언트가 사용하는 Faraday 어댑터입니다. 기본값은 typhoeus 입니다. 사용할 수 있는 값은 typhoeus와 net_http 입니다. GitLab 18.5에서 도입되었습니다. Premium 및 Ultimate 전용입니다.
elasticsearch_indexed_field_length_limit integer no Elasticsearch가 인덱싱하는 텍스트 필드의 최대 크기입니다. 값이 0 이면 제한이 없습니다. 리포지터리와 위키 인덱싱에는 적용되지 않습니다. Premium 및 Ultimate 전용입니다.
elasticsearch_indexed_file_size_limit_kb integer no Elasticsearch가 인덱싱하는 리포지터리 및 위키 파일의 최대 크기입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_indexing boolean no 고급 검색을 위한 인덱싱을 켭니다. Premium 및 Ultimate 전용입니다.
elasticsearch_requeue_workers boolean no 인덱싱 워커의 자동 재큐잉을 활성화합니다. 모든 문서가 처리될 때까지 Sidekiq job을 큐에 넣어 코드 외 인덱싱 처리량을 높입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_limit_indexing boolean no Elasticsearch가 특정 네임스페이스와 프로젝트만 인덱싱하도록 제한합니다. Premium 및 Ultimate 전용입니다.
elasticsearch_max_bulk_concurrency integer no 인덱싱 작업당 Elasticsearch 벌크 요청의 최대 동시 실행 수입니다. 리포지터리 인덱싱 작업에만 적용됩니다. Premium 및 Ultimate 전용입니다.
elasticsearch_max_code_indexing_concurrency integer no Elasticsearch 코드 인덱싱 백그라운드 job의 최대 동시 실행 수입니다. 리포지터리 인덱싱 작업에만 적용됩니다. Premium 및 Ultimate 전용입니다.
elasticsearch_worker_number_of_shards integer no 인덱싱 워커 샤드 수입니다. 병렬 Sidekiq job을 더 많이 큐에 넣어 코드 외 인덱싱 처리량을 높입니다. 기본값은 2 입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_max_bulk_size_mb integer no Elasticsearch 벌크 인덱싱 요청의 최대 크기(MB)입니다. 리포지터리 인덱싱 작업에만 적용됩니다. Premium 및 Ultimate 전용입니다.
elasticsearch_namespace_ids array of integers no elasticsearch_limit_indexing 이 활성화된 경우 Elasticsearch로 인덱싱할 네임스페이스입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_project_ids array of integers no elasticsearch_limit_indexing 이 활성화된 경우 Elasticsearch로 인덱싱할 프로젝트입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_search boolean no Elasticsearch 검색을 활성화합니다. Premium 및 Ultimate 전용입니다.
elasticsearch_url string or array of strings no Elasticsearch에 연결할 때 사용할 URL 입니다. 클러스터를 지원하려면 쉼표로 구분한 목록이나 배열을 사용합니다(예: http://localhost:9200, http://localhost:9201 또는 ["http://localhost:9200", "http://localhost:9201"]). Premium 및 Ultimate 전용입니다.
elasticsearch_username string no Elasticsearch 인스턴스의 username 입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_password string no Elasticsearch 인스턴스의 비밀번호입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_prefix string no Elasticsearch 인덱스 이름에 붙일 커스텀 접두사입니다. 기본값은 gitlab 입니다. 1~100자여야 하고 소문자 영숫자, 하이픈, 밑줄만 사용할 수 있으며 하이픈이나 밑줄로 시작하거나 끝날 수 없습니다. Premium 및 Ultimate 전용입니다.
elasticsearch_retry_on_failure integer no Elasticsearch 검색 요청의 최대 재시도 횟수입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_shards integer or object Yes, if elasticsearch_replicas is defined as an object Elasticsearch 인덱스의 샤드 수입니다. 모든 인덱스에 같은 값을 적용하려면 정수를 사용하고, 인덱스별로 값을 지정하려면 객체를 사용합니다. 예: {"gitlab-production": 5, "gitlab-production-notes": 3}.
객체를 사용할 때는 각 인덱스에 elasticsearch_shards와 elasticsearch_replicas를 모두 지정해야 합니다. 어느 한 값이라도 빠지면 해당 인덱스는 건너뜁니다. Premium 및 Ultimate 전용입니다.
elasticsearch_replicas integer or object Yes, if elasticsearch_shards is defined as an object Elasticsearch 인덱스의 복제본 수입니다. 모든 인덱스에 같은 값을 적용하려면 정수를 사용하고, 인덱스별로 값을 지정하려면 객체를 사용합니다. 예: {"gitlab-production": 1, "gitlab-production-notes": 2}.
객체를 사용할 때는 각 인덱스에 elasticsearch_shards와 elasticsearch_replicas를 모두 지정해야 합니다. 어느 한 값이라도 빠지면 해당 인덱스는 건너뜁니다. Premium 및 Ultimate 전용입니다.
email_additional_text string no 법률·감사·컴플라이언스 목적으로 모든 이메일 하단에 추가되는 텍스트입니다. Premium 및 Ultimate 전용입니다.
email_author_in_body boolean no 일부 메일 서버는 발신자 이름 재정의를 지원하지 않습니다. 이 옵션을 활성화하면 이슈, 머지 리퀘스트, 댓글 작성자의 이름이 이메일 본문에 포함됩니다.
email_confirmation_setting string no 로그인 전에 이메일을 확인해야 하는지 지정합니다. 사용할 수 있는 값은 off, soft, hard 입니다.
email_otp_enabled boolean no 이메일 기반 일회용 비밀번호(OTP)를 다중 인증 방식으로 활성화합니다. 기본적으로 비활성화되어 있습니다. require_email_verification_on_account_locked가 true 여야 합니다.
custom_http_clone_url_root string no HTTP(S) 용 커스텀 Git 클론 URL을 설정합니다.
enabled_git_access_protocol string no Git 접근에 허용되는 프로토콜입니다. 허용되는 값은 ssh, http, 두 프로토콜을 모두 허용하는 all 입니다.
enforce_namespace_storage_limit boolean no 활성화하면 네임스페이스 스토리지 제한을 강제할 수 있습니다.
enforce_terms boolean no (활성화 시 필요: terms) 모든 사용자에게 애플리케이션 이용약관을 강제합니다.
external_auth_client_cert string no (활성화 시 필요: external_auth_client_key) 외부 인가 서비스 인증에 사용할 인증서입니다.
external_auth_client_key_pass string no 외부 서비스 인증 시 개인 키에 사용할 암호이며, 저장할 때 암호화됩니다.
external_auth_client_key string required by: external_auth_client_cert 외부 인가 서비스에 인증이 필요할 때 사용하는 인증서의 개인 키이며, 저장할 때 암호화됩니다.
external_authorization_service_default_label string required by:
external_authorization_service_enabled		 인가를 요청할 때 프로젝트에 분류 레이블이 지정되어 있지 않은 경우 사용할 기본 분류 레이블입니다.
external_authorization_service_enabled boolean no (활성화 시 필요: external_authorization_service_default_label, external_authorization_service_timeout, external_authorization_service_url) 프로젝트 접근에 외부 인가 서비스를 사용하도록 활성화합니다.
external_authorization_service_timeout float required by:
external_authorization_service_enabled		 인가 요청을 중단하기까지의 타임아웃(초)입니다. 요청이 타임아웃되면 사용자의 접근이 거부됩니다. (최소: 0.001, 최대: 10, 단위: 0.001)
external_authorization_service_url string required by:
external_authorization_service_enabled		 인가 요청을 보낼 URL 입니다.
external_pipeline_validation_service_url string no 파이프라인 검증 요청에 사용할 URL 입니다.
external_pipeline_validation_service_token string no 선택 사항입니다. external_pipeline_validation_service_url의 URL로 요청할 때 X-Gitlab-Token 헤더에 포함할 토큰입니다.
external_pipeline_validation_service_timeout integer no 파이프라인 검증 서비스의 응답을 기다리는 시간입니다. 타임아웃되면 OK로 간주합니다.
static_objects_external_storage_url string no 리포지터리 정적 오브젝트용 외부 스토리지의 URL 입니다.
static_objects_external_storage_auth_token string required by: static_objects_external_storage_url static_objects_external_storage_url에 연결된 외부 스토리지의 인증 토큰입니다.
failed_login_attempts_unlock_period_in_minutes integer no 로그인 실패 횟수가 최대치에 도달한 사용자의 잠금이 해제되기까지의 기간(분)입니다.
file_template_project_id integer no 커스텀 파일 템플릿을 불러올 프로젝트의 ID 입니다. Premium 및 Ultimate 전용입니다.
first_day_of_week integer no 캘린더 보기와 날짜 선택기에서 한 주의 시작 요일입니다. 사용할 수 있는 값은 일요일은 0(기본값), 월요일은 1, 토요일은 6 입니다.
globally_allowed_ips string no 인바운드 트래픽에 항상 허용되는 IP 주소와 CIDR을 쉼표로 구분한 목록입니다. 예: 1.1.1.1, 2.2.2.0/24.
geo_node_allowed_ips string yes 허용되는 보조 노드의 IP와 CIDR을 쉼표로 구분한 목록입니다. 예: 1.1.1.1, 2.2.2.0/24. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
geo_status_timeout integer no 보조 노드 상태 조회 요청이 타임아웃되기까지의 시간(초)입니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
git_two_factor_session_expiry integer no 2FA가 활성화된 경우 Git 작업 세션의 최대 지속 시간(분)입니다. Premium 및 Ultimate 전용입니다.
gitaly_timeout_default integer no 기본 Gitaly 타임아웃(초)입니다. 이 타임아웃은 Git fetch/push 작업이나 Sidekiq job에는 적용되지 않습니다. 타임아웃을 해제하려면 0으로 설정합니다.
gitaly_timeout_fast integer no Gitaly 빠른 작업의 타임아웃(초)입니다. 일부 Gitaly 작업은 빠르게 끝나야 합니다. 이 임곗값을 넘으면 스토리지 샤드에 문제가 있을 수 있으며, 빠르게 실패시키면 GitLab 인스턴스의 안정성을 유지하는 데 도움이 됩니다. 타임아웃을 해제하려면 0으로 설정합니다.
gitaly_timeout_medium integer no 중간 수준 Gitaly 타임아웃(초)입니다. 빠른 작업 타임아웃과 기본 타임아웃 사이의 값이어야 합니다. 타임아웃을 해제하려면 0으로 설정합니다.
gitlab_dedicated_instance boolean no 인스턴스가 GitLab Dedicated 용으로 프로비저닝되었는지 여부입니다.
gitlab_environment_toolkit_instance boolean no Service Ping 보고를 위해 인스턴스가 GitLab Environment Toolkit으로 프로비저닝되었는지 여부입니다.
gitlab_shell_operation_limit integer no 사용자가 1분간 수행할 수 있는 최대 Git 작업 수입니다. 기본값: 600.
grafana_enabled boolean no Grafana를 활성화합니다.
grafana_url string no Grafana URL 입니다.
gravatar_enabled boolean no Gravatar를 활성화합니다.
group_owners_can_manage_default_branch_protection boolean no 기본 브랜치 보호의 재정의를 막습니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
hashed_storage_enabled boolean no 해시 스토리지 경로로 새 프로젝트를 생성합니다. 변경되지 않는 해시 기반 경로와 리포지터리 이름으로 디스크에 리포지터리를 저장합니다. 이렇게 하면 프로젝트 URL 이 바뀌어도 리포지터리를 옮기거나 이름을 바꿀 필요가 없고 디스크 I/O 성능이 좋아질 수 있습니다. (GitLab 13.0 이상에서는 항상 활성화되며, 이 구성은 14.0에서 제거될 예정입니다)
help_page_hide_commercial_content boolean no 도움말에서 마케팅 관련 항목을 숨깁니다.
help_page_support_url string no 도움말 페이지와 도움말 드롭다운 목록에 사용할 대체 지원 URL 입니다.
help_page_documentation_base_url string no 대체 문서 페이지 URL 입니다.
help_page_text string no 도움말 페이지에 표시되는 커스텀 텍스트입니다.
hide_third_party_offers boolean no GitLab에 서드파티 제안을 표시하지 않습니다.
home_page_url string no 로그인하지 않은 경우 이 URL로 리디렉션합니다.
housekeeping_bitmaps_enabled boolean no 사용 중단되었습니다. Git 팩파일 비트맵 생성은 항상 활성화되어 있으며 API와 UI로 변경할 수 없습니다. 항상 true를 반환합니다.
housekeeping_enabled boolean no Git 하우스키핑을 활성화하거나 비활성화합니다. 추가 필드를 설정해야 합니다.
housekeeping_full_repack_period integer no 사용 중단되었습니다. 증분 git repack을 실행하기까지의 Git 푸시 횟수입니다. 대신 housekeeping_optimize_repository_period를 사용합니다.
housekeeping_gc_period integer no 사용 중단되었습니다. git gc를 실행하기까지의 Git 푸시 횟수입니다. 대신 housekeeping_optimize_repository_period를 사용합니다.
housekeeping_incremental_repack_period integer no 사용 중단되었습니다. 증분 git repack을 실행하기까지의 Git 푸시 횟수입니다. 대신 housekeeping_optimize_repository_period를 사용합니다.
housekeeping_optimize_repository_period integer no 증분 git repack을 실행하기까지의 Git 푸시 횟수입니다.
html_emails_enabled boolean no HTML 이메일을 활성화합니다.
import_sources array of strings no 프로젝트 가져오기를 허용할 소스입니다. 사용할 수 있는 값은 github, bitbucket, bitbucket_server, fogbugz, git, gitlab_project, gitea, manifest 입니다.
invisible_captcha_enabled boolean no 계정 생성 시 Invisible CAPTCHA 스팸 탐지를 활성화합니다. 기본적으로 비활성화되어 있습니다.
issues_create_limit integer no 사용자당 분당 최대 이슈 생성 요청 수입니다. 기본적으로 비활성화되어 있습니다.
jira_connect_application_key string no GitLab for Jira Cloud 앱 인증에 사용하는 OAuth 애플리케이션의 ID 입니다.
jira_connect_public_key_storage_enabled boolean no GitLab for Jira Cloud 앱의 공개 키 저장을 활성화합니다.
jira_connect_proxy_url string no GitLab for Jira Cloud 앱의 프록시로 사용되는 GitLab 인스턴스의 URL 입니다.
keep_latest_artifact boolean no 만료 시간과 관계없이 가장 최근 성공한 job의 아티팩트가 삭제되지 않도록 합니다. 기본적으로 활성화되어 있습니다.
local_markdown_version integer no 캐시된 Markdown을 무효화해야 할 때 이 값을 올립니다.
lock_memberships_to_saml boolean no SAML 그룹 멤버십 전역 잠금을 강제합니다.
mailgun_signing_key string no 웹훅에서 이벤트를 수신할 때 사용하는 Mailgun HTTP 웹훅 서명 키입니다.
mailgun_events_enabled boolean no Mailgun 이벤트 수신기를 활성화합니다.
maintenance_mode_message string no 인스턴스가 유지 보수 모드일 때 표시되는 메시지입니다. Premium 및 Ultimate 전용입니다.
maintenance_mode boolean no 인스턴스가 유지 보수 모드이면 관리자가 아닌 사용자는 읽기 전용으로 로그인하고 읽기 전용 API 요청을 보낼 수 있습니다. Premium 및 Ultimate 전용입니다.
max_artifacts_size integer no 최대 아티팩트 크기(MB)입니다.
max_attachment_size integer no 첨부 파일 크기 제한(MB)입니다.
max_decompressed_archive_size integer no 가져온 아카이브의 최대 압축 해제 파일 크기(MB)입니다. 무제한으로 하려면 0으로 설정합니다. 기본값은 25600 입니다.
max_export_size integer no 최대 내보내기 크기(MB)입니다. 0 이면 무제한입니다. 기본값은 0(무제한)입니다.
max_github_response_size_limit integer no 허용되는 GitHub API 응답의 최대 크기(MB)입니다. 0 이면 무제한입니다.
max_github_response_json_value_count integer no GitHub API 응답에서 허용되는 최대 값 개수입니다. 0 이면 무제한입니다. 개수는 응답에 포함된 :, ,, {, [의 등장 횟수를 기준으로 추정합니다.
max_http_decompressed_size integer no 아웃바운드 요청에서 받은 Gzip 압축 HTTP 응답의 압축 해제 후 허용되는 최대 크기(MiB)입니다. 0 이면 무제한입니다.
max_http_response_json_depth integer no 아웃바운드 요청에서 받은 JSON HTTP 응답에 허용되는 최대 중첩 깊이입니다.
max_http_response_json_structural_chars integer no 아웃바운드 요청에서 받은 JSON HTTP 응답에 허용되는 최대 객체 수입니다. 개수는 응답에 포함된 :, ,, {, [의 등장 횟수를 기준으로 추정합니다. GitLab 18.4에서 도입되었습니다.
max_http_response_xml_structural_chars integer no 아웃바운드 요청에서 받은 XML HTTP 응답에 허용되는 최대 객체 수입니다. 개수는 응답에 포함된 <와 =의 등장 횟수를 기준으로 추정합니다. GitLab 18.4에서 도입되었습니다.
max_http_response_csv_structural_chars integer no 아웃바운드 요청에서 받은 CSV HTTP 응답에 허용되는 최대 객체 수입니다. 개수는 응답에 포함된 ,, ;, \t, \n의 등장 횟수를 기준으로 추정합니다. GitLab 18.4에서 도입되었습니다.
max_http_response_size_limit integer no 아웃바운드 요청에서 받은 HTTP 응답에 허용되는 최대 크기(MiB)입니다. 0 이면 무제한입니다. 통합, 임포터, 웹훅에 적용됩니다. GitLab 18.4에서 도입되었습니다.
max_import_size integer no 최대 가져오기 크기(MB)입니다. 0 이면 무제한입니다. 기본값은 0(무제한)입니다.
max_import_remote_file_size integer no 외부 오브젝트 스토리지에서 가져올 때의 최대 원격 파일 크기입니다.
max_login_attempts integer no 사용자를 잠그기까지 허용되는 최대 로그인 시도 횟수입니다.
max_pages_size integer no Pages 리포지터리의 최대 크기(MB)입니다.
max_personal_access_token_lifetime integer no 액세스 토큰에 허용되는 최대 수명(일)입니다. 비워 두면 기본값 365가 적용됩니다. 설정할 경우 값은 365 이하여야 합니다. 값을 변경하면 최대 허용 수명을 넘는 만료일을 가진 기존 액세스 토큰은 폐기됩니다. GitLab Self-Managed의 Ultimate 전용입니다. GitLab 17.6 이상에서는 buffered_token_expiration_limit라는 기능 플래그를 활성화해 최대 수명 제한을 400일까지 연장할 수 있습니다.
max_ssh_key_lifetime integer no SSH 키에 허용되는 최대 수명(일)입니다. GitLab Self-Managed의 Ultimate 전용입니다. GitLab 17.6 이상에서는 buffered_token_expiration_limit라는 기능 플래그를 활성화해 최대 수명 제한을 400일까지 연장할 수 있습니다.
max_terraform_state_size_bytes integer no Terraform 상태 파일의 최대 크기(바이트)입니다. 파일 크기를 무제한으로 하려면 0으로 설정합니다.
metrics_method_call_threshold integer no 메서드 호출은 지정한 밀리초보다 오래 걸릴 때만 추적됩니다.
max_number_of_repository_downloads integer no 사용자가 차단되기 전 지정한 기간 동안 다운로드할 수 있는 고유 리포지터리의 최대 개수입니다. 기본값: 0, 최대: 10,000개. GitLab Self-Managed의 Ultimate 전용입니다.
max_number_of_repository_downloads_within_time_period integer no 보고 기간(초)입니다. 기본값: 0, 최대: 864000초(10일). GitLab Self-Managed의 Ultimate 전용입니다.
max_yaml_depth integer no include 키워드로 추가한 중첩 CI/CD 구성의 최대 깊이입니다. 기본값: 100.
max_yaml_size_bytes integer no 단일 CI/CD 구성 파일의 최대 크기(바이트)입니다. 기본값: 2097152.
git_rate_limit_users_allowlist array of strings no Git 악용 방지 속도 제한에서 제외되는 사용자 이름 목록입니다. 기본값: [], 최대: 사용자 이름 100개. GitLab Self-Managed의 Ultimate 전용입니다.
git_rate_limit_users_alertlist array of integers no Git 악용 속도 제한을 초과했을 때 이메일을 받는 사용자 ID 목록입니다. 기본값: [], 최대: 사용자 ID 100개. GitLab Self-Managed의 Ultimate 전용입니다.
auto_ban_user_on_excessive_projects_download boolean no 활성화하면 max_number_of_repository_downloads와 max_number_of_repository_downloads_within_time_period로 지정한 기간 동안 최대 고유 프로젝트 수를 초과해 다운로드한 사용자는 애플리케이션에서 자동으로 차단됩니다. GitLab Self-Managed의 Ultimate 전용입니다.
mirror_available boolean no 프로젝트 Maintainer가 리포지터리 미러링을 구성하도록 허용합니다. 비활성화하면 관리자만 리포지터리 미러링을 구성할 수 있습니다.
mirror_capacity_threshold integer no 미러를 선제적으로 추가 예약하기 전에 확보해야 하는 최소 용량입니다. Premium 및 Ultimate 전용입니다.
mirror_max_capacity integer no 동시에 동기화할 수 있는 최대 미러 수입니다. Premium 및 Ultimate 전용입니다.
mirror_max_delay integer no 동기화가 예약된 미러의 업데이트 간 최대 간격(분)입니다. Premium 및 Ultimate 전용입니다.
maven_package_requests_forwarding boolean no Maven 패키지를 GitLab 패키지 레지스트리에서 찾지 못한 경우 repo.maven.apache.org를 기본 원격 리포지터리로 사용합니다. Premium 및 Ultimate 전용입니다.
npm_package_requests_forwarding boolean no npm 패키지를 GitLab 패키지 레지스트리에서 찾지 못한 경우 npmjs.org를 기본 원격 리포지터리로 사용합니다. Premium 및 Ultimate 전용입니다.
pypi_package_requests_forwarding boolean no PyPI 패키지를 GitLab 패키지 레지스트리에서 찾지 못한 경우 pypi.org를 기본 원격 리포지터리로 사용합니다. Premium 및 Ultimate 전용입니다.
rubygems_package_requests_forwarding boolean no RubyGems 패키지를 GitLab 패키지 레지스트리에서 찾지 못한 경우 rubygems.org를 기본 원격 리포지터리로 사용합니다. Premium 및 Ultimate 전용입니다.
oauth_access_token_expires_in integer no 인스턴스가 발급하는 모든 새 OAuth 액세스 토큰의 최대 수명(초)입니다. 최솟값: 300(5분). 기본값: 7200(2시간). 비어 있거나 null 이면 기본값을 사용합니다. 기존 OAuth 액세스 토큰에는 영향을 주지 않습니다.
outbound_local_requests_whitelist array of strings no 웹훅과 통합의 로컬 요청이 비활성화된 경우에도 로컬 요청을 허용할 신뢰 도메인 또는 IP 주소 목록을 정의합니다. 현재 이 속성은 업데이트할 수 없습니다. 자세한 내용은 이슈 569729를 참고합니다.
package_registry_allow_anyone_to_pull_option boolean no 패키지 레지스트리에서 누구나 가져오기 허용 설정을 표시하고 변경할 수 있게 합니다.
package_metadata_purl_types array of integers no 동기화할 패키지 레지스트리 메타데이터 목록입니다. 사용할 수 있는 값은 목록을 참고합니다. GitLab Self-Managed의 Ultimate 전용입니다.
pages_domain_verification_enabled boolean no 사용자가 커스텀 도메인의 소유권을 증명하도록 요구합니다. 도메인 검증은 공개 GitLab 사이트의 필수 보안 조치입니다. 사용자는 도메인이 활성화되기 전에 해당 도메인을 통제하고 있음을 증명해야 합니다.
pages_unique_domain_default_enabled boolean no 네임스페이스에 속한 사이트 간에 쿠키가 공유되지 않도록 Pages 사이트에 고유 도메인을 기본으로 활성화합니다. 기본값은 true 입니다.
password_authentication_enabled_for_git boolean no GitLab 계정 비밀번호로 HTTP(S) 기반 Git 인증을 활성화합니다. 기본값은 true 입니다.
password_authentication_enabled_for_web boolean no GitLab 계정 비밀번호로 웹 인터페이스 인증을 활성화합니다. 기본값은 true 입니다.
minimum_password_length integer no 비밀번호에 최소 길이를 요구하는지 여부입니다. Premium 및 Ultimate 전용입니다.
password_number_required boolean no 비밀번호에 숫자를 하나 이상 요구하는지 여부입니다. Premium 및 Ultimate 전용입니다.
password_symbol_required boolean no 비밀번호에 기호 문자를 하나 이상 요구하는지 여부입니다. Premium 및 Ultimate 전용입니다.
password_uppercase_required boolean no 비밀번호에 대문자를 하나 이상 요구하는지 여부입니다. Premium 및 Ultimate 전용입니다.
password_lowercase_required boolean no 비밀번호에 소문자를 하나 이상 요구하는지 여부입니다. Premium 및 Ultimate 전용입니다.
performance_bar_allowed_group_id string no (사용 중단: 대신 performance_bar_allowed_group_path를 사용합니다) 성능 바를 전환할 수 있는 그룹의 경로입니다.
performance_bar_allowed_group_path string no 성능 바를 전환할 수 있는 그룹의 경로입니다.
performance_bar_enabled boolean no (사용 중단: 대신 performance_bar_allowed_group_path: nil을 전달합니다) 성능 바를 활성화할 수 있게 합니다.
personal_access_token_prefix string no 생성되는 모든 개인 액세스 토큰에 붙는 접두사입니다.
pipeline_limit_per_project_user_sha integer no 사용자와 커밋별로 분당 최대 파이프라인 생성 요청 수입니다. 기본적으로 비활성화되어 있습니다.
pipeline_limit_per_user integer no 사용자당 분당 최대 파이프라인 생성 요청 수입니다.
ci_lint_limit_per_user integer no 사용자당 분당 최대 CI Lint 요청 수입니다. 기본적으로 비활성화되어 있습니다.
gitpod_enabled boolean no (활성화 시 필요: gitpod_url) Ona 통합을 활성화합니다. 기본값은 false 입니다.
gitpod_url string required by: gitpod_enabled 통합에 사용할 Ona 인스턴스 URL 입니다.
inactive_resource_access_tokens_delete_after_days integer no 비활성 프로젝트 및 그룹 액세스 토큰의 보존 기간을 지정합니다. 기본값은 30 입니다.
kroki_enabled boolean no (활성화 시 필요: kroki_url) Kroki 통합을 활성화합니다. 기본값은 false 입니다.
kroki_url string required by: kroki_enabled 통합에 사용할 Kroki 인스턴스 URL 입니다.
kroki_formats object no Kroki 인스턴스가 지원하는 추가 형식입니다. bpmn, blockdiag, excalidraw, mermaid 형식에 대해 <format>: true 또는 <format>: false 형태로 true 나 false를 지정할 수 있습니다.
kroki_diagram_proxy_enabled boolean no Kroki 다이어그램 프록시를 활성화합니다. 기본값은 false 입니다.
plantuml_enabled boolean no (활성화 시 필요: plantuml_url) PlantUML 통합을 활성화합니다. 기본값은 false 입니다.
plantuml_url string required by: plantuml_enabled 통합에 사용할 PlantUML 인스턴스 URL 입니다.
plantuml_diagram_proxy_enabled boolean no PlantUML 다이어그램 프록시를 활성화합니다. 기본값은 false 입니다.
polling_interval_multiplier float no 폴링을 수행하는 엔드포인트가 사용하는 간격 배수입니다. 폴링을 해제하려면 0으로 설정합니다.
project_export_enabled boolean no 프로젝트 내보내기를 활성화합니다.
project_jobs_api_rate_limit integer no /project/:id/jobs에 대한 분당 최대 인증 요청 수입니다. 기본값: 600.
projects_api_rate_limit_unauthenticated integer no 모든 프로젝트 조회 API에 대한 비인증 요청의 IP 주소당 10분간 최대 요청 수입니다. 기본값: 400. 제한을 해제하려면 0으로 설정합니다.
runner_jobs_request_api_limit integer no /jobs/request 러너 job API 엔드포인트에 대한 러너 토큰당 분당 최대 요청 수입니다. 기본값: 2000. 제한을 해제하려면 0으로 설정합니다. GitLab 18.5에서 도입되었습니다.
runner_jobs_patch_trace_api_limit integer no PATCH /jobs/:id/trace 러너 job API 엔드포인트에 대한 러너 토큰당 분당 최대 요청 수입니다. 기본값: 2000. 제한을 해제하려면 0으로 설정합니다. GitLab 18.5에서 도입되었습니다.
runner_jobs_endpoints_api_limit integer no 러너 job API 엔드포인트의 /jobs/* 요청에 대한 job 토큰당 분당 최대 요청 수입니다. 기본값: 200. 제한을 해제하려면 0으로 설정합니다. GitLab 18.5에서 도입되었습니다.
users_api_limit_following integer no 사용자 또는 IP 주소당 분당 최대 요청 수입니다. 기본값: 100. 제한을 해제하려면 0으로 설정합니다. GitLab 17.10에서 도입되었습니다.
users_api_limit_followers integer no 사용자 또는 IP 주소당 분당 최대 요청 수입니다. 기본값: 100. 제한을 해제하려면 0으로 설정합니다. GitLab 17.10에서 도입되었습니다.
users_api_limit_status integer no 사용자 또는 IP 주소당 분당 최대 요청 수입니다. 기본값: 240. 제한을 해제하려면 0으로 설정합니다. GitLab 17.10에서 도입되었습니다.
users_api_limit_keys integer no 사용자 또는 IP 주소당 분당 최대 요청 수입니다. 기본값: 120. 제한을 해제하려면 0으로 설정합니다. GitLab 17.10에서 도입되었습니다.
users_api_limit_key integer no 사용자 또는 IP 주소당 분당 최대 요청 수입니다. 기본값: 120. 제한을 해제하려면 0으로 설정합니다. GitLab 17.10에서 도입되었습니다.
users_api_limit_gpg_keys integer no 사용자 또는 IP 주소당 분당 최대 요청 수입니다. 기본값: 120. 제한을 해제하려면 0으로 설정합니다. GitLab 17.10에서 도입되었습니다.
users_api_limit_gpg_key integer no 사용자 또는 IP 주소당 분당 최대 요청 수입니다. 기본값: 120. 제한을 해제하려면 0으로 설정합니다. GitLab 17.10에서 도입되었습니다.
virtual_registries_endpoints_api_limit integer no 가상 레지스트리 엔드포인트에 대한 IP 주소당 15초간 최대 요청 수입니다. 기본값: 4000. 제한을 해제하려면 0으로 설정합니다. GitLab 17.11에서 도입되었습니다.
project_secrets_limit integer no Secrets Manager에서 프로젝트당 허용되는 최대 시크릿 수입니다. 기본값: 100. 제한을 해제하려면 0으로 설정합니다. Ultimate 전용입니다. GitLab 18.9에서 도입되었습니다.
group_secrets_limit integer no Secrets Manager에서 그룹당 허용되는 최대 시크릿 수입니다. 기본값: 500. 제한을 해제하려면 0으로 설정합니다. Ultimate 전용입니다. GitLab 18.9에서 도입되었습니다.
prometheus_metrics_enabled boolean no Prometheus 메트릭을 활성화합니다.
protected_ci_variables boolean no CI/CD 변수를 기본적으로 보호합니다.
disable_overriding_approvers_per_merge_request boolean no 프로젝트와 머지 리퀘스트에서 승인 규칙을 편집하지 못하도록 막습니다
prevent_merge_requests_author_approval boolean no 머지 리퀘스트 생성자(작성자)의 승인을 막습니다
prevent_merge_requests_committers_approval boolean no 머지 리퀘스트에 커밋한 사람의 승인을 막습니다
push_event_activities_limit integer no 한 번의 푸시에서 대량 푸시 이벤트가 생성되는 기준이 되는 최대 변경(브랜치 또는 태그) 수입니다. 0으로 설정해도 제한이 해제되지는 않습니다.
push_event_hooks_limit integer no 한 번의 푸시에서 웹훅과 통합이 트리거되지 않는 기준이 되는 최대 변경(브랜치 또는 태그) 수입니다. 0으로 설정해도 제한이 해제되지는 않습니다. 기본값: 3.
rate_limiting_response_text string no throttle_* 설정으로 속도 제한을 활성화한 경우, 속도 제한을 초과하면 이 일반 텍스트 응답을 보냅니다. 비워 두면 'Retry later' 가 전송됩니다.
raw_blob_request_limit integer no raw 경로별 분당 최대 요청 수입니다(기본값은 300). 제한을 해제하려면 0으로 설정합니다.
raw_blob_request_limit_unauthenticated integer no 프로젝트의 모든 raw 경로를 합친 분당 최대 비인증 요청 수입니다(기본값은 800). 제한을 해제하려면 0으로 설정합니다.
search_rate_limit integer no 인증된 상태에서 검색을 수행할 때의 분당 최대 요청 수입니다. 기본값: 30. 제한을 해제하려면 0으로 설정합니다.
search_rate_limit_unauthenticated integer no 인증되지 않은 상태에서 검색을 수행할 때의 분당 최대 요청 수입니다. 기본값: 10. 제한을 해제하려면 0으로 설정합니다.
recaptcha_enabled boolean no (활성화 시 필요: recaptcha_private_key와 recaptcha_site_key) reCAPTCHA를 활성화합니다.
login_recaptcha_protection_enabled boolean no 로그인에 reCAPTCHA를 활성화합니다.
recaptcha_private_key string required by: recaptcha_enabled reCAPTCHA의 개인 키입니다.
recaptcha_site_key string required by: recaptcha_enabled reCAPTCHA의 사이트 키입니다.
receptive_cluster_agents_enabled boolean no Kubernetes 용 GitLab 에이전트의 수신 모드를 활성화합니다.
receive_max_input_size integer no 최대 푸시 크기(MB)입니다.
relation_export_batch_size integer no 배치 관계를 내보낼 때 각 배치의 크기입니다. GitLab 18.2에서 도입되었습니다.
remember_me_enabled boolean no Remember me 설정을 활성화합니다.
repository_checks_enabled boolean no GitLab은 디스크 손상 문제를 조용히 넘기지 않도록 모든 프로젝트와 위키 리포지터리에서 주기적으로 git fsck를 실행합니다.
repository_size_limit integer no 리포지터리당 크기 제한(MB)입니다. Premium 및 Ultimate 전용입니다.
repository_storages_weighted hash of strings to integers no gitlab.yml에서 가져온 이름과 가중치의 해시입니다. 새 프로젝트는 가중치 기반 무작위 선택으로 이 스토어 중 하나에 생성됩니다.
require_admin_approval_after_user_signup boolean no 활성화하면 가입 양식으로 계정을 만든 사용자는 Pending approval 상태가 되며, 관리자가 명시적으로 승인해야 합니다.
require_email_verification_on_account_locked boolean no true 이면 의심스러운 로그인 활동이 감지된 후 인스턴스의 모든 사용자가 본인 인증을 해야 합니다.
require_personal_access_token_expiry boolean no 활성화하면 사용자는 그룹 또는 프로젝트 액세스 토큰이나, 서비스 계정이 아닌 사용자가 소유한 개인 액세스 토큰을 생성할 때 만료일을 설정해야 합니다.
require_sha_for_merge boolean no 머지 리퀘스트 머지 엔드포인트 호출에 유효한 커밋 sha를 요구하는 인스턴스 기본값입니다. GitLab 19.2에서 도입되었습니다.
lock_require_sha_for_merge boolean no 인스턴스의 모든 그룹에 require_sha_for_merge 설정을 강제합니다. GitLab 19.2에서 도입되었습니다.
require_two_factor_authentication boolean no (활성화 시 필요: two_factor_grace_period) 모든 사용자에게 2단계 인증 설정을 요구합니다.
resource_usage_limits hash no Sidekiq 워커에 적용되는 리소스 사용량 제한의 정의입니다. 이 설정은 GitLab.com 에서만 사용할 수 있습니다.
restricted_visibility_levels array of strings no 선택한 수준은 관리자가 아닌 사용자가 그룹, 프로젝트, 스니펫에 사용할 수 없습니다. private, internal, public을 파라미터로 받을 수 있습니다. 기본값은 null 이며 제한이 없음을 의미합니다. default_project_visibility와 default_group_visibility로 설정된 수준은 선택할 수 없습니다.
rsa_key_restriction integer no 업로드할 수 있는 RSA 키의 최소 비트 길이입니다. 기본값은 0(제한 없음)입니다. -1은 RSA 키를 비활성화합니다.
session_expire_delay integer no 세션 지속 시간(분)입니다. 변경 사항을 적용하려면 GitLab을 재시작해야 합니다.
session_expire_from_init boolean no true 이면 마지막 활동 이후가 아니라 세션이 생성된 후 일정 시간이 지나면 세션이 만료됩니다. 이 세션 수명은 session_expire_delay로 정의합니다.
security_policy_global_group_approvers_enabled boolean no 머지 리퀘스트 승인 정책의 승인 그룹을 전역에서 찾을지, 프로젝트 계층 안에서 찾을지 여부입니다.
security_approval_policies_limit integer no 보안 정책 프로젝트당 활성 머지 리퀘스트 승인 정책의 최대 개수입니다. 기본값: 5. 최대: 20
scan_execution_policies_action_limit integer no 스캔 실행 정책당 actions의 최대 개수입니다. 기본값: 0. 최대: 20
scan_execution_policies_schedule_limit integer no 스캔 실행 정책당 type: schedule 규칙의 최대 개수입니다. 기본값: 0. 최대: 20
security_txt_content string no 공개 보안 연락처 정보입니다.
security_mr_report_cache_lifetime_minutes integer no 머지 리퀘스트의 보안 리포트를 캐시하는 시간(분)입니다(10~60). 기본값: 10. Premium 및 Ultimate 전용입니다. GitLab 18.10에서 도입되었습니다.
security_scan_stale_after_days integer no 보안 스캔 데이터를 삭제하기 전에 보관하는 일수입니다. 7일에서 90일 사이여야 합니다. 기본값: GitLab.com은 30일, GitLab Self-Managed는 90일. Premium 및 Ultimate 전용입니다. GitLab 18.9에서 도입되었습니다.
service_access_tokens_expiration_enforced boolean no 서비스 계정 사용자의 토큰 만료일을 선택 사항으로 둘 수 있는지 나타내는 플래그입니다. Premium 및 Ultimate 전용입니다.
shared_runners_enabled boolean no (활성화 시 필요: shared_runners_text와 shared_runners_minutes) 새 프로젝트에 인스턴스 러너를 활성화합니다.
shared_runners_minutes integer required by: shared_runners_enabled 그룹이 인스턴스 러너에서 월간 사용할 수 있는 최대 컴퓨팅 분을 설정합니다. Premium 및 Ultimate 전용입니다.
shared_runners_text string required by: shared_runners_enabled 인스턴스 러너 안내 문구입니다.
runner_token_expiration_interval integer no 새로 등록되는 인스턴스 러너의 인증 토큰 만료 시간(초)을 설정합니다. 최솟값은 7200초입니다. 자세한 내용은 인증 토큰 자동 교체를 참고합니다.
group_runner_token_expiration_interval integer no 새로 등록되는 그룹 러너의 인증 토큰 만료 시간(초)을 설정합니다. 최솟값은 7200초입니다. 자세한 내용은 인증 토큰 자동 교체를 참고합니다.
project_runner_token_expiration_interval integer no 새로 등록되는 프로젝트 러너의 인증 토큰 만료 시간(초)을 설정합니다. 최솟값은 7200초입니다. 자세한 내용은 인증 토큰 자동 교체를 참고합니다.
sidekiq_job_limiter_mode string no track 또는 compress 입니다. Sidekiq job 크기 제한의 동작을 설정합니다. 기본값: 'compress'.
sidekiq_job_limiter_compression_threshold_bytes integer no Sidekiq job을 Redis에 저장하기 전에 압축하는 기준 크기(바이트)입니다. 기본값: 100,000바이트(100 KB).
sidekiq_job_limiter_limit_bytes integer no Sidekiq job을 거부하는 기준 크기(바이트)입니다. 기본값: 0바이트(어떤 job도 거부하지 않음).
sidekiq_timezone_override string no 모든 Sidekiq cron job에 적용되는 IANA 시간대 식별자입니다(예: America/Chicago). 비워 두면 재정의가 적용되지 않고 cron job은 Rails 애플리케이션 시간대를 사용합니다.
signin_enabled string no (사용 중단: 대신 password_authentication_enabled_for_web을 사용합니다) 웹 인터페이스에 비밀번호 인증이 활성화되어 있는지 나타내는 플래그입니다.
sign_in_restrictions hash no 애플리케이션 로그인 제한입니다.
signup_enabled boolean no 가입을 활성화합니다. 기본값은 true 입니다.
silent_admin_exports_enabled boolean no 관리자 무음 내보내기를 활성화합니다. 기본값은 false 입니다.
silent_mode_enabled boolean no 무음 모드를 활성화합니다. 기본값은 false 입니다.
slack_app_enabled boolean no (활성화 시 필요: slack_app_id, slack_app_secret, slack_app_signing_secret, slack_app_verification_token) GitLab for Slack 앱을 활성화합니다.
slack_app_id string required by: slack_app_enabled GitLab for Slack 앱의 클라이언트 ID 입니다.
slack_app_secret string required by: slack_app_enabled GitLab for Slack 앱의 클라이언트 시크릿입니다. 앱에서 오는 OAuth 요청을 인증하는 데 사용합니다.
slack_app_signing_secret string required by: slack_app_enabled GitLab for Slack 앱의 서명 시크릿입니다. 앱에서 오는 API 요청을 인증하는 데 사용합니다.
slack_app_verification_token string required by: slack_app_enabled GitLab for Slack 앱의 검증 토큰입니다. 이 인증 방식은 Slack에서 사용 중단되었으며 앱의 슬래시 명령 인증에만 사용됩니다.
snippet_size_limit integer no 스니펫 내용의 최대 크기(바이트)입니다. 기본값: 52428800바이트(50 MB).
snowplow_app_id string no Snowplow 사이트 이름 또는 애플리케이션 ID 입니다. (예: gitlab)
snowplow_collector_hostname string required by: snowplow_enabled Snowplow 컬렉터 호스트 이름입니다. (예: your-snowplow-collector.example.com)
snowplow_database_collector_hostname string no 데이터베이스 이벤트용 Snowplow 컬렉터의 호스트 이름입니다. (예: your-db-snowplow-collector.example.com)
snowplow_cookie_domain string no Snowplow 쿠키 도메인입니다. (예: .gitlab.com)
snowplow_enabled boolean no Snowplow 추적을 활성화합니다.
sourcegraph_enabled boolean no Sourcegraph 통합을 활성화합니다. 기본값은 false 입니다. 활성화하려면 sourcegraph_url 이 필요합니다.
sourcegraph_public_only boolean no 비공개 및 내부 프로젝트에서 Sourcegraph가 로드되지 않도록 막습니다. 기본값은 true 입니다.
sourcegraph_url string required by: sourcegraph_enabled 통합에 사용할 Sourcegraph 인스턴스 URL 입니다.
spam_check_endpoint_enabled boolean no 외부 Spam Check API 엔드포인트를 사용한 스팸 검사를 활성화합니다. 기본값은 false 입니다.
spam_check_endpoint_url string no 외부 Spamcheck 서비스 엔드포인트의 URL 입니다. 사용할 수 있는 URI 스킴은 grpc 또는 tls 입니다. tls를 지정하면 통신이 암호화됩니다.
spam_check_api_key string no GitLab 이 Spam Check 서비스 엔드포인트에 접근할 때 사용하는 API 키입니다.
enable_artifact_external_redirect_warning_page boolean no GitLab Pages의 사용자 생성 콘텐츠에 대해 경고하는 외부 리디렉션 페이지를 표시합니다.
tags_create_limit integer no 프로젝트당 30분간 허용되는 최대 태그 생성 요청 수입니다. 태그를 생성하는 REST API 엔드포인트, GraphQL tagCreate 뮤테이션, UI의 태그 생성, /tag 퀵 액션에 적용됩니다. 기본값: 100. 속도 제한을 해제하려면 0으로 설정합니다.
terminal_max_session_time integer no 웹 터미널 웹소켓 연결의 최대 시간(초)입니다. 시간을 무제한으로 하려면 0으로 설정합니다.
terms text required by: enforce_terms (다음 설정에 필요: enforce_terms) 이용약관의 Markdown 콘텐츠입니다.
throttle_authenticated_api_enabled boolean no (활성화 시 필요: throttle_authenticated_api_period_in_seconds와 throttle_authenticated_api_requests_per_period) 인증된 API 요청의 속도 제한을 활성화합니다. 크롤러나 악성 봇 등에서 오는 요청량을 줄이는 데 도움이 됩니다.
throttle_authenticated_api_period_in_seconds integer required by:
throttle_authenticated_api_enabled		 속도 제한 기간(초)입니다.
throttle_authenticated_api_requests_per_period integer required by:
throttle_authenticated_api_enabled		 사용자당 기간별 최대 요청 수입니다.
throttle_authenticated_dependency_proxy_enabled boolean conditionally true 이면 인증된 의존성 프록시 요청의 속도 제한을 적용합니다. 기본값: false.
throttle_authenticated_dependency_proxy_period_in_seconds integer no 속도 제한 기간(초)입니다. throttle_authenticated_dependency_proxy_enabled가 true 여야 합니다. 기본값: 15.
throttle_authenticated_dependency_proxy_requests_per_period integer no 사용자당 기간별 최대 요청 수입니다. throttle_authenticated_dependency_proxy_enabled가 true 여야 합니다. 기본값: 1000.
throttle_authenticated_git_http_enabled boolean conditionally true 이면 인증된 Git HTTP 요청의 속도 제한을 적용합니다. 기본값: false.
throttle_authenticated_git_http_period_in_seconds integer no 속도 제한 기간(초)입니다. throttle_authenticated_git_http_enabled가 true 여야 합니다. 기본값: 3600.
throttle_authenticated_git_http_requests_per_period integer no 사용자당 기간별 최대 요청 수입니다. throttle_authenticated_git_http_enabled가 true 여야 합니다. 기본값: 3600.
throttle_authenticated_packages_api_enabled boolean no (활성화 시 필요: throttle_authenticated_packages_api_period_in_seconds와 throttle_authenticated_packages_api_requests_per_period) 인증된 API 요청의 속도 제한을 활성화합니다. 크롤러나 악성 봇 등에서 오는 요청량을 줄이는 데 도움이 됩니다. 자세한 내용은 패키지 레지스트리 속도 제한을 참고합니다.
throttle_authenticated_packages_api_period_in_seconds integer required by:
throttle_authenticated_packages_api_enabled		 속도 제한 기간(초)입니다. 자세한 내용은 패키지 레지스트리 속도 제한을 참고합니다.
throttle_authenticated_packages_api_requests_per_period integer required by:
throttle_authenticated_packages_api_enabled		 사용자당 기간별 최대 요청 수입니다. 자세한 내용은 패키지 레지스트리 속도 제한을 참고합니다.
throttle_authenticated_web_enabled boolean no (활성화 시 필요: throttle_authenticated_web_period_in_seconds와 throttle_authenticated_web_requests_per_period) 인증된 웹 요청의 속도 제한을 활성화합니다. 크롤러나 악성 봇 등에서 오는 요청량을 줄이는 데 도움이 됩니다.
throttle_authenticated_web_period_in_seconds integer required by:
throttle_authenticated_web_enabled		 속도 제한 기간(초)입니다.
throttle_authenticated_web_requests_per_period integer required by:
throttle_authenticated_web_enabled		 사용자당 기간별 최대 요청 수입니다.
throttle_unauthenticated_enabled boolean no (GitLab 14.3에서 사용 중단되었습니다. 대신 throttle_unauthenticated_web_enabled 또는 throttle_unauthenticated_api_enabled를 사용합니다.) (활성화 시 필요: throttle_unauthenticated_period_in_seconds와 throttle_unauthenticated_requests_per_period) 인증되지 않은 웹 요청의 속도 제한을 활성화합니다. 크롤러나 악성 봇 등에서 오는 요청량을 줄이는 데 도움이 됩니다.
throttle_unauthenticated_period_in_seconds integer required by:
throttle_unauthenticated_enabled		 (GitLab 14.3에서 사용 중단되었습니다. 대신 throttle_unauthenticated_web_period_in_seconds 또는 throttle_unauthenticated_api_period_in_seconds를 사용합니다.) 속도 제한 기간(초)입니다.
throttle_unauthenticated_requests_per_period integer required by:
throttle_unauthenticated_enabled		 (GitLab 14.3에서 사용 중단되었습니다. 대신 throttle_unauthenticated_web_requests_per_period 또는 throttle_unauthenticated_api_requests_per_period를 사용합니다.) IP 당 기간별 최대 요청 수입니다.
throttle_unauthenticated_api_enabled boolean no (활성화 시 필요: throttle_unauthenticated_api_period_in_seconds와 throttle_unauthenticated_api_requests_per_period) 인증되지 않은 API 요청의 속도 제한을 활성화합니다. 크롤러나 악성 봇 등에서 오는 요청량을 줄이는 데 도움이 됩니다.
throttle_unauthenticated_api_period_in_seconds integer required by:
throttle_unauthenticated_api_enabled		 속도 제한 기간(초)입니다.
throttle_unauthenticated_api_requests_per_period integer required by:
throttle_unauthenticated_api_enabled		 IP 당 기간별 최대 요청 수입니다.
throttle_unauthenticated_git_http_enabled boolean conditionally true 이면 인증되지 않은 Git HTTP 요청의 속도 제한을 적용합니다. 기본값: false.
throttle_unauthenticated_git_http_period_in_seconds integer no 속도 제한 기간(초)입니다. throttle_unauthenticated_git_http_enabled가 true 여야 합니다. 기본값: 3600.
throttle_unauthenticated_git_http_requests_per_period integer no IP 당 기간별 최대 요청 수입니다. throttle_unauthenticated_git_http_enabled가 true 여야 합니다. 기본값: 3600.
throttle_unauthenticated_packages_api_enabled boolean no (활성화 시 필요: throttle_unauthenticated_packages_api_period_in_seconds와 throttle_unauthenticated_packages_api_requests_per_period) 인증되지 않은 API 요청의 속도 제한을 활성화합니다. 크롤러나 악성 봇 등에서 오는 요청량을 줄이는 데 도움이 됩니다. 자세한 내용은 패키지 레지스트리 속도 제한을 참고합니다.
throttle_unauthenticated_packages_api_period_in_seconds integer required by:
throttle_unauthenticated_packages_api_enabled		 속도 제한 기간(초)입니다. 자세한 내용은 패키지 레지스트리 속도 제한을 참고합니다.
throttle_unauthenticated_packages_api_requests_per_period integer required by:
throttle_unauthenticated_packages_api_enabled		 사용자당 기간별 최대 요청 수입니다. 자세한 내용은 패키지 레지스트리 속도 제한을 참고합니다.
throttle_unauthenticated_web_enabled boolean no (활성화 시 필요: throttle_unauthenticated_web_period_in_seconds와 throttle_unauthenticated_web_requests_per_period) 인증되지 않은 웹 요청의 속도 제한을 활성화합니다. 크롤러나 악성 봇 등에서 오는 요청량을 줄이는 데 도움이 됩니다.
throttle_unauthenticated_web_period_in_seconds integer required by:
throttle_unauthenticated_web_enabled		 속도 제한 기간(초)입니다.
throttle_unauthenticated_web_requests_per_period integer required by:
throttle_unauthenticated_web_enabled		 IP 당 기간별 최대 요청 수입니다.
time_tracking_limit_to_hours boolean no 시간 추적 단위를 시간 단위로만 표시하도록 제한합니다. 기본값은 false 입니다.
top_level_group_creation_enabled boolean no 사용자가 최상위 그룹을 생성할 수 있게 합니다. 기본값은 true 입니다.
two_factor_grace_period integer required by: require_two_factor_authentication 사용자가 2단계 인증의 강제 설정을 건너뛸 수 있는 시간(시간 단위)입니다.
unconfirmed_users_delete_after_days integer no 계정 생성 후 이메일을 확인하지 않은 사용자를 며칠 뒤에 삭제할지 지정합니다. delete_unconfirmed_users가 true 인 경우에만 적용됩니다. 1 이상이어야 합니다. 기본값은 7 입니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
unique_ips_limit_enabled boolean no (활성화 시 필요: unique_ips_limit_per_user와 unique_ips_limit_time_window) 여러 IP 에서의 로그인을 제한합니다.
unique_ips_limit_per_user integer required by: unique_ips_limit_enabled 사용자당 최대 IP 수입니다.
unique_ips_limit_time_window integer required by: unique_ips_limit_enabled IP가 제한 집계에 포함되는 시간(초)입니다.
update_runner_versions_enabled boolean no GitLab.com에서 GitLab Runner 릴리스 버전 데이터를 가져옵니다. 자세한 내용은 업그레이드가 필요한 러너 확인 방법을 참고합니다.
usage_ping_enabled boolean no GitLab은 매주 라이선스 사용량을 GitLab, Inc. 에 보고합니다.
gitlab_product_usage_data_enabled boolean no 제품 사용 데이터 수집이 활성화되어 있는지 여부입니다. GITLAB_PRODUCT_USAGE_DATA_ENABLED 환경 변수가 설정되어 있으면 API는 환경 변수의 적용값을 반환합니다.
gitlab_product_usage_data_source string no 읽기 전용입니다. gitlab_product_usage_data_enabled 설정의 출처를 나타냅니다. GITLAB_PRODUCT_USAGE_DATA_ENABLED 환경 변수가 설정되어 있으면 environment를, 그렇지 않으면 database를 반환합니다.
use_clickhouse_for_analytics boolean no 분석 리포트의 데이터 소스로 ClickHouse를 사용합니다. 이 설정이 적용되려면 ClickHouse가 구성되어 있어야 합니다. Premium 및 Ultimate 에서만 사용할 수 있습니다.
use_nats_for_audit_streaming boolean no 감사 이벤트 스트리밍을 NATS JetStream으로 전달합니다. 이 설정이 적용되려면 NATS가 구성되어 있어야 합니다. Premium 및 Ultimate 에서만 사용할 수 있습니다.
include_optional_metrics_in_service_ping boolean no Service Ping에서 선택 메트릭을 활성화할지 여부입니다.
user_deactivation_emails_enabled boolean no 계정 비활성화 시 사용자에게 이메일을 보냅니다.
user_default_external boolean no 새로 가입한 사용자를 기본적으로 외부 사용자로 지정합니다.
user_default_internal_regex string no 기본 내부 사용자를 식별할 이메일 주소 정규 표현식 패턴을 지정합니다.
user_defaults_to_private_profile boolean no 새로 생성된 사용자의 프로필을 기본적으로 비공개로 지정합니다. 기본값은 false 입니다.
user_oauth_applications boolean no 사용자가 GitLab을 OAuth 공급자로 사용하도록 애플리케이션을 등록할 수 있게 허용합니다. 이 설정은 그룹 수준 OAuth 애플리케이션에는 영향을 주지 않습니다.
user_show_add_ssh_key_message boolean no false로 설정하면 SSH 키를 업로드하지 않은 사용자에게 표시되는 You won't be able to pull or push repositories via SSH until you add an SSH key to your profile 경고가 비활성화됩니다.
version_check_enabled boolean no 업데이트가 있을 때 GitLab 이 알려주도록 합니다.
valid_runner_registrars array of strings no GitLab Runner를 등록할 수 있는 유형의 목록입니다. [], ['group'], ['project'], ['group', 'project'] 중 하나일 수 있습니다.
vscode_extension_marketplace hash no VS Code Extension Marketplace 설정입니다. Web IDE와 워크스페이스에서 사용합니다.
web_hook_event_resend_limit integer no 특정 프로젝트 또는 그룹에 대해 사용자당 분당 최대 웹훅 이벤트 재전송 요청 수입니다. 기본값: 5. 제한을 해제하려면 0으로 설정합니다. GitLab 19.3에서 도입되었습니다.
web_hook_test_limit integer no 특정 프로젝트 또는 그룹에 대해 사용자당 분당 최대 웹훅 테스트 요청 수입니다. 기본값: 5. 제한을 해제하려면 0으로 설정합니다. GitLab 19.3에서 도입되었습니다.
whats_new_variant string no What's new 표시 방식이며, 사용할 수 있는 값은 all_tiers, current_tier, disabled 입니다.
wiki_page_max_content_bytes integer no 위키 페이지 내용의 최대 크기(바이트)입니다. 기본값: 5242880바이트(5 MB). 최솟값은 1024바이트입니다.
bulk_import_concurrent_pipeline_batch_limit integer no 동시에 처리할 수 있는 최대 직접 전송 배치 내보내기 수입니다.
concurrent_relation_batch_export_limit integer no 동시에 처리할 수 있는 최대 배치 내보내기 job 수입니다. GitLab 17.6에서 도입되었습니다.
concurrent_relation_export_limit integer no 동시에 처리할 수 있는 최대 프로젝트 파일 내보내기 수입니다. 기본값: 25. GitLab 19.4에서 도입되었습니다.
asciidoc_max_includes integer no 한 문서에서 처리되는 AsciiDoc include 지시문의 최대 개수입니다. 기본값: 32. 최대: 64.
duo_custom_agents_enabled boolean no 이 인스턴스에서 커스텀 에이전트를 허용하는지 여부입니다. 기본값: true. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. GitLab 19.0에서 도입되었습니다.
duo_custom_flows_enabled boolean no 이 인스턴스에서 커스텀 플로를 허용하는지 여부입니다. 기본값: true. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. GitLab 19.0에서 도입되었습니다.
duo_external_agents_enabled boolean no 이 인스턴스에서 외부 에이전트를 허용하는지 여부입니다. 기본값: true. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. GitLab 19.0에서 도입되었습니다.
duo_features_enabled boolean no 이 인스턴스에서 GitLab Duo 기능이 활성화되어 있는지 여부입니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
lock_duo_custom_agents_enabled boolean no 커스텀 에이전트 활성화 설정을 모든 그룹에 강제하는지 여부입니다. 기본값: false. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. GitLab 19.0에서 도입되었습니다.
lock_duo_custom_flows_enabled boolean no 커스텀 플로 활성화 설정을 모든 그룹에 강제하는지 여부입니다. 기본값: false. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. GitLab 19.0에서 도입되었습니다.
lock_duo_external_agents_enabled boolean no 외부 에이전트 활성화 설정을 모든 그룹에 강제하는지 여부입니다. 기본값: false. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. GitLab 19.0에서 도입되었습니다.
lock_duo_features_enabled boolean no GitLab Duo 기능 활성화 설정을 모든 하위 그룹에 강제하는지 여부입니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
nuget_skip_metadata_url_validation boolean no NuGet 패키지의 메타데이터 URL 검증을 건너뛸지 여부입니다. GitLab 17.0에서 도입되었습니다.
helm_max_packages_count integer no 채널당 조회할 수 있는 최대 Helm 패키지 수입니다. 1 이상이어야 합니다. 기본값은 1000 입니다.
require_admin_two_factor_authentication boolean no 관리자가 인스턴스의 모든 관리자에게 2FA를 요구할 수 있게 허용합니다.
secret_push_protection_available boolean no 프로젝트가 시크릿 푸시 보호를 활성화할 수 있게 허용합니다. 이 설정 자체가 시크릿 푸시 보호를 켜지는 않습니다. Ultimate 전용입니다.
disable_invite_members boolean no 그룹의 멤버 초대 기능을 비활성화합니다.
enforce_pipl_compliance boolean no SaaS 애플리케이션에 PIPL 컴플라이언스를 강제할지 설정합니다
iframe_rendering_enabled boolean no Markdown에서 iframe 렌더링을 허용합니다. 기본적으로 비활성화되어 있습니다.
iframe_rendering_allowlist array of strings no 콘텐츠 보안 정책과 새니타이즈에 사용되는, 허용된 iframe src host[:port] 항목의 목록입니다.
iframe_rendering_allowlist_raw string no 허용된 iframe src host[:port] 항목을 줄바꿈 또는 쉼표로 구분한 원본 목록입니다.
usage_billing object no 사용량 청구 설정입니다. 스키마 정의는 ee/app/validators/json_schemas/usage_billing_settings.json을 참고합니다

휴면 프로젝트 설정#

휴면 프로젝트 삭제를 구성하거나 해제할 수 있습니다.

속성 유형 필수 설명
delete_inactive_projects boolean no 휴면 프로젝트 삭제를 활성화합니다. 기본값은 false 입니다.
inactive_projects_delete_after_months integer no delete_inactive_projects가 true 인 경우, 휴면 프로젝트를 삭제하기까지 대기하는 기간(개월)입니다. 기본값은 2 입니다.
inactive_projects_min_size_mb integer no delete_inactive_projects가 true 인 경우, 휴면 여부를 검사할 프로젝트의 최소 리포지터리 크기입니다. 기본값은 0 입니다.
inactive_projects_send_warning_email_after_months integer no delete_inactive_projects가 true 인 경우, 프로젝트가 휴면 상태여서 삭제 예정임을 Maintainer에게 이메일로 알리기까지 대기하는 기간(개월)을 설정합니다. 기본값은 1 입니다.

패키지 레지스트리 설정: 패키지 파일 크기 제한#

패키지 파일 크기 제한은 애플리케이션 설정 API에 포함되지 않습니다. 이 설정은 플랜 제한 API로 접근할 수 있습니다.

관련 주제#

애플리케이션 설정 API

GitLab v19.4
Tier: Free, Premium, Ultimate
Offering: GitLab Self-Managed, GitLab Dedicated
원문 보기

요약

이 API를 사용하여 GitLab 인스턴스의 애플리케이션 설정을 다룹니다. 애플리케이션 설정 변경은 캐시의 영향을 받으므로 즉시 반영되지 않을 수 있습니다. 이 GitLab 인스턴스의 현재 애플리케이션 설정 세부 정보를 조회합니다.

이 API를 사용하여 GitLab 인스턴스의 애플리케이션 설정을 다룹니다.

애플리케이션 설정 변경은 캐시의 영향을 받으므로 즉시 반영되지 않을 수 있습니다. 기본적으로 GitLab은 애플리케이션 설정을 60초 동안 캐시합니다. 인스턴스의 애플리케이션 설정 캐시를 제어하는 방법은 애플리케이션 캐시 간격을 참고합니다.

사전 요구 사항:

  • 인스턴스에 대한 관리자 접근 권한이 있어야 합니다.

현재 애플리케이션 설정의 세부 정보 조회#

히스토리

이 GitLab 인스턴스의 현재 애플리케이션 설정 세부 정보를 조회합니다.

GET /application/settings

curl --request GET \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/application/settings"

응답 예시:

{
  "default_projects_limit" : 100000,
  "signup_enabled" : true,
  "id" : 1,
  "default_branch_protection" : 2,
  "default_branch_protection_defaults": {
        "allowed_to_push": [
            {
                "access_level": 40
            }
        ],
        "allow_force_push": false,
        "allowed_to_merge": [
            {
                "access_level": 40
            }
        ]
    },
  "default_preferred_language" : "en",
  "deletion_adjourned_period": 7,
  "failed_login_attempts_unlock_period_in_minutes": 30,
  "restricted_visibility_levels" : [],
  "sign_in_restrictions": {},
  "password_authentication_enabled_for_web" : true,
  "after_sign_out_path" : null,
  "max_attachment_size" : 100,
  "max_decompressed_archive_size": 25600,
  "max_export_size": 50,
  "max_import_size": 50,
  "max_import_remote_file_size": 10240,
  "max_login_attempts": 3,
  "user_oauth_applications" : true,
  "updated_at" : "2016-01-04T15:44:55.176Z",
  "session_expire_delay" : 10080,
  "home_page_url" : null,
  "default_snippet_visibility" : "private",
  "outbound_local_requests_whitelist": [],
  "domain_allowlist" : [],
  "domain_denylist_enabled" : false,
  "domain_denylist" : [],
  "created_at" : "2016-01-04T15:44:55.176Z",
  "default_ci_config_path" : null,
  "default_project_visibility" : "private",
  "default_group_visibility" : "private",
  "gravatar_enabled" : true,
  "container_expiration_policies_enable_historic_entries": true,
  "container_registry_cleanup_tags_service_max_list_size": 200,
  "container_registry_delete_tags_service_timeout": 250,
  "container_registry_expiration_policies_caching": true,
  "container_registry_expiration_policies_worker_capacity": 4,
  "container_registry_token_expire_delay": 5,
  "oauth_access_token_expires_in": 7200,
  "decompress_archive_file_timeout": 210,
  "repository_storages_weighted": {"default": 100},
  "plantuml_enabled": false,
  "plantuml_url": null,
  "diagramsnet_enabled": true,
  "diagramsnet_url": "https://embed.diagrams.net",
  "kroki_enabled": false,
  "kroki_url": null,
  "terminal_max_session_time": 0,
  "polling_interval_multiplier": 1.0,
  "rsa_key_restriction": 0,
  "dsa_key_restriction": 0,
  "ecdsa_key_restriction": 0,
  "ed25519_key_restriction": 0,
  "ecdsa_sk_key_restriction": 0,
  "ed25519_sk_key_restriction": 0,
  "first_day_of_week": 0,
  "enforce_terms": true,
  "terms": "Hello world!",
  "inactive_resource_access_tokens_delete_after_days": 30,
  "performance_bar_allowed_group_id": 42,
  "user_show_add_ssh_key_message": true,
  "allow_account_deletion": true,
  "updating_name_disabled_for_users": false,
  "local_markdown_version": 0,
  "allow_local_requests_from_hooks_and_services": true,
  "allow_local_requests_from_web_hooks_and_services": true,
  "allow_local_requests_from_system_hooks": false,
  "asset_proxy_enabled": true,
  "asset_proxy_url": "https://assets.example.com",
  "asset_proxy_whitelist": ["example.com", "*.example.com", "your-instance.com"],
  "asset_proxy_allowlist": ["example.com", "*.example.com", "your-instance.com"],
  "maven_package_requests_forwarding": true,
  "npm_package_requests_forwarding": true,
  "pypi_package_requests_forwarding": true,
  "rubygems_package_requests_forwarding": false,
  "snippet_size_limit": 52428800,
  "issues_create_limit": 300,
  "raw_blob_request_limit": 300,
  "raw_blob_request_limit_unauthenticated": 800,
  "wiki_page_max_content_bytes": 5242880,
  "require_admin_approval_after_user_signup": false,
  "require_personal_access_token_expiry": true,
  "personal_access_token_prefix": "glpat-",
  "rate_limiting_response_text": null,
  "keep_latest_artifact": true,
  "admin_mode": false,
  "floc_enabled": false,
  "external_pipeline_validation_service_timeout": null,
  "external_pipeline_validation_service_token": null,
  "external_pipeline_validation_service_url": null,
  "jira_connect_application_key": null,
  "jira_connect_public_key_storage_enabled": false,
  "jira_connect_proxy_url": null,
  "jira_connect_additional_audience_url": null,
  "silent_mode_enabled": false,
  "package_registry_allow_anyone_to_pull_option": true,
  "bulk_import_max_download_file_size": 5120,
  "project_jobs_api_rate_limit": 600,
  "runner_jobs_request_api_limit": 2000,
  "runner_jobs_patch_trace_api_limit": 200,
  "runner_jobs_endpoints_api_limit": 200,
  "security_txt_content": null,
  "security_scan_stale_after_days": 90,
  "bulk_import_concurrent_pipeline_batch_limit": 25,
  "concurrent_relation_batch_export_limit": 25,
  "concurrent_relation_export_limit": 25,
  "relation_export_batch_size": 50,
  "concurrent_github_import_jobs_limit": 1000,
  "concurrent_bitbucket_import_jobs_limit": 100,
  "concurrent_bitbucket_server_import_jobs_limit": 100,
  "concurrent_pull_request_import_jobs_limit": 200,
  "import_jobs_concurrency_limit": 100,
  "silent_admin_exports_enabled": false,
  "top_level_group_creation_enabled": true,
  "disable_invite_members": false,
  "enforce_pipl_compliance": true,
  "model_prompt_cache_enabled": true,
  "lock_model_prompt_cache_enabled": false
}

GitLab Premium 또는 Ultimate 사용자는 다음 파라미터도 확인할 수 있습니다.

  • allow_all_integrations
  • allowed_integrations
  • audit_events_api_limit
  • default_project_deletion_protection
  • delete_unconfirmed_users
  • dependency_scanning_sbom_scan_api_download_limit
  • dependency_scanning_sbom_scan_api_upload_limit
  • disable_personal_access_tokens
  • duo_features_enabled
  • elasticsearch_index_settings
  • file_template_project_id
  • geo_node_allowed_ips
  • geo_status_timeout
  • group_owners_can_manage_default_branch_protection
  • lock_duo_features_enabled
  • scan_execution_policies_action_limit
  • scan_execution_policies_schedule_limit
  • secret_push_protection_available
  • security_approval_policies_limit
  • security_policy_global_group_approvers_enabled
  • unconfirmed_users_delete_after_days
  • use_clickhouse_for_analytics
  • virtual_registries_endpoints_api_limit
  • project_secrets_limit
  • group_secrets_limit
  • security_mr_report_cache_lifetime_minutes
  • security_scan_stale_after_days
  • service_access_tokens_expiration_enforced
{
  "allow_all_integrations": true,
  "allowed_integrations": [],
  "default_project_deletion_protection": false,
  "disable_personal_access_tokens": false,
  "duo_features_enabled": true,
  "elasticsearch_index_settings": [
    {
      "alias_name": "gitlab-production",
      "number_of_shards": 5,
      "number_of_replicas": 1
    }
  ],
  "file_template_project_id": 1,
  "geo_node_allowed_ips": "0.0.0.0/0, ::/0",
  "group_owners_can_manage_default_branch_protection": true,
  "id": 1,
  "lock_duo_features_enabled": false,
  "signup_enabled": true,
  "virtual_registries_endpoints_api_limit": 4000,
  "project_secrets_limit": 100,
  "group_secrets_limit": 500
  ...
}

애플리케이션 설정 업데이트#

히스토리
  • GitLab 17.0에서 default_branch_protection 이 사용 중단되었습니다. 대신 default_branch_protection_defaults를 사용합니다.
  • GitLab 17.0에서 throttle_unauthenticated_git_http_enabled, throttle_unauthenticated_git_http_period_in_seconds, throttle_unauthenticated_git_http_requests_per_period 속성이 추가되었습니다.
  • GitLab 17.6에서 allow_all_integrations 및 allowed_integrations 속성이 추가되었습니다.
  • GitLab 18.1에서 throttle_authenticated_git_http_enabled, throttle_authenticated_git_http_period_in_seconds, throttle_authenticated_git_http_requests_per_period 속성이 git_authenticated_http_limit라는 기능 플래그와 함께 추가되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 18.3에서 git_authenticated_http_limit 기능 플래그가 활성화되었습니다.
  • GitLab 18.4에서 git_authenticated_http_limit 기능 플래그가 제거되었습니다.
  • GitLab 19.4에서 throttle_authenticated_dependency_proxy_enabled, throttle_authenticated_dependency_proxy_period_in_seconds, throttle_authenticated_dependency_proxy_requests_per_period 속성이 추가되었습니다.

이 GitLab 인스턴스의 현재 애플리케이션 설정을 업데이트합니다.

PUT /application/settings

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/application/settings" \
  --data "signup_enabled=false" \
  --data "default_project_visibility=internal"

응답 예시:

{
  "id": 1,
  "default_projects_limit": 100000,
  "default_preferred_language": "en",
  "failed_login_attempts_unlock_period_in_minutes": 30,
  "signup_enabled": false,
  "password_authentication_enabled_for_web": true,
  "gravatar_enabled": true,
  "created_at": "2015-06-12T15:51:55.432Z",
  "updated_at": "2015-06-30T13:22:42.210Z",
  "home_page_url": "",
  "default_branch_protection": 2,
  "default_branch_protection_defaults": {
    "allowed_to_push": [
        {
            "access_level": 40
        }
    ],
    "allow_force_push": false,
    "allowed_to_merge": [
        {
            "access_level": 40
        }
    ]
  },
  "restricted_visibility_levels": [],
  "sign_in_restrictions": {},
  "max_attachment_size": 100,
  "max_decompressed_archive_size": 25600,
  "max_export_size": 50,
  "max_import_size": 50,
  "max_import_remote_file_size": 10240,
  "max_login_attempts": 3,
  "session_expire_delay": 10080,
  "default_ci_config_path" : null,
  "default_project_visibility": "internal",
  "default_snippet_visibility": "private",
  "default_group_visibility": "private",
  "outbound_local_requests_whitelist": [],
  "domain_allowlist": [],
  "domain_denylist_enabled" : false,
  "domain_denylist" : [],
  "external_authorization_service_enabled": true,
  "external_authorization_service_url": "https://authorize.me",
  "external_authorization_service_default_label": "default",
  "external_authorization_service_timeout": 0.5,
  "user_oauth_applications": true,
  "after_sign_out_path": "",
  "container_expiration_policies_enable_historic_entries": true,
  "container_registry_cleanup_tags_service_max_list_size": 200,
  "container_registry_delete_tags_service_timeout": 250,
  "container_registry_expiration_policies_caching": true,
  "container_registry_expiration_policies_worker_capacity": 4,
  "container_registry_token_expire_delay": 5,
  "oauth_access_token_expires_in": 7200,
  "decompress_archive_file_timeout": 210,
  "package_registry_cleanup_policies_worker_capacity": 2,
  "plantuml_enabled": false,
  "plantuml_url": null,
  "diagramsnet_enabled": true,
  "diagramsnet_url": "https://embed.diagrams.net",
  "terminal_max_session_time": 0,
  "polling_interval_multiplier": 1.0,
  "rsa_key_restriction": 0,
  "dsa_key_restriction": 0,
  "ecdsa_key_restriction": 0,
  "ed25519_key_restriction": 0,
  "ecdsa_sk_key_restriction": 0,
  "ed25519_sk_key_restriction": 0,
  "first_day_of_week": 0,
  "enforce_terms": true,
  "terms": "Hello world!",
  "inactive_resource_access_tokens_delete_after_days": 30,
  "performance_bar_allowed_group_id": 42,
  "user_show_add_ssh_key_message": true,
  "file_template_project_id": 1,
  "local_markdown_version": 0,
  "asset_proxy_enabled": true,
  "asset_proxy_url": "https://assets.example.com",
  "asset_proxy_allowlist": ["example.com", "*.example.com", "your-instance.com"],
  "globally_allowed_ips": "",
  "geo_node_allowed_ips": "0.0.0.0/0, ::/0",
  "allow_local_requests_from_hooks_and_services": true,
  "allow_local_requests_from_web_hooks_and_services": true,
  "allow_local_requests_from_system_hooks": false,
  "maven_package_requests_forwarding": true,
  "npm_package_requests_forwarding": true,
  "pypi_package_requests_forwarding": true,
  "rubygems_package_requests_forwarding": false,
  "snippet_size_limit": 52428800,
  "issues_create_limit": 300,
  "raw_blob_request_limit": 300,
  "raw_blob_request_limit_unauthenticated": 800,
  "wiki_page_max_content_bytes": 5242880,
  "require_admin_approval_after_user_signup": false,
  "require_personal_access_token_expiry": true,
  "personal_access_token_prefix": "glpat-",
  "rate_limiting_response_text": null,
  "keep_latest_artifact": true,
  "admin_mode": false,
  "external_pipeline_validation_service_timeout": null,
  "external_pipeline_validation_service_token": null,
  "external_pipeline_validation_service_url": null,
  "can_create_group": false,
  "jira_connect_application_key": "123",
  "jira_connect_public_key_storage_enabled": true,
  "jira_connect_proxy_url": "http://gitlab.example.com",
  "user_defaults_to_private_profile": true,
  "projects_api_rate_limit_unauthenticated": 400,
  "runner_jobs_request_api_limit": 2000,
  "runner_jobs_patch_trace_api_limit": 200,
  "runner_jobs_endpoints_api_limit": 200,
  "users_api_limit_followers": 100,
  "users_api_limit_following": 100,
  "users_api_limit_status": 240,
  "users_api_limit_ssh_keys": 120,
  "users_api_limit_ssh_key": 120,
  "users_api_limit_gpg_keys": 120,
  "users_api_limit_gpg_key": 120,
  "web_hook_event_resend_limit": 5,
  "web_hook_test_limit": 5,
  "silent_mode_enabled": false,
  "security_policy_global_group_approvers_enabled": true,
  "security_approval_policies_limit": 5,
  "scan_execution_policies_action_limit": 0,
  "scan_execution_policies_schedule_limit": 0,
  "package_registry_allow_anyone_to_pull_option": true,
  "bulk_import_max_download_file_size": 5120,
  "project_jobs_api_rate_limit": 600,
  "security_txt_content": null,
  "security_scan_stale_after_days": 90,
  "bulk_import_concurrent_pipeline_batch_limit": 25,
  "concurrent_relation_batch_export_limit": 25,
  "concurrent_relation_export_limit": 25,
  "relation_export_batch_size": 50,
  "downstream_pipeline_trigger_limit_per_project_user_sha": 0,
  "concurrent_github_import_jobs_limit": 1000,
  "concurrent_bitbucket_import_jobs_limit": 100,
  "concurrent_bitbucket_server_import_jobs_limit": 100,
  "concurrent_pull_request_import_jobs_limit": 200,
  "import_jobs_concurrency_limit": 100,
  "silent_admin_exports_enabled": false,
  "enforce_pipl_compliance": true
}

GitLab Premium 또는 Ultimate 사용자는 다음 파라미터도 확인할 수 있습니다.

  • allow_all_integrations
  • allowed_integrations
  • audit_events_api_limit
  • group_owners_can_manage_default_branch_protection
  • file_template_project_id
  • geo_node_allowed_ips
  • geo_status_timeout
  • default_project_deletion_protection
  • disable_personal_access_tokens
  • security_policy_global_group_approvers_enabled
  • security_approval_policies_limit
  • scan_execution_policies_action_limit
  • scan_execution_policies_schedule_limit
  • delete_unconfirmed_users
  • unconfirmed_users_delete_after_days
  • duo_features_enabled
  • lock_duo_features_enabled
  • use_clickhouse_for_analytics
  • virtual_registries_endpoints_api_limit
  • lock_memberships_to_saml
  • security_mr_report_cache_lifetime_minutes
  • security_scan_stale_after_days
  • service_access_tokens_expiration_enforced

응답 예시:

  "file_template_project_id": 1,
  "geo_node_allowed_ips": "0.0.0.0/0, ::/0",
  "duo_features_enabled": true,
  "lock_duo_features_enabled": false,
  "allow_all_integrations": true,
  "allowed_integrations": [],
  "virtual_registries_endpoints_api_limit": 4000

사용 가능한 설정#

히스토리
  • GitLab 17.0에서 silent_admin_exports_enabled가 도입되었습니다.
  • GitLab 17.2에서 ai_action_api_rate_limit가 도입되었습니다.
  • GitLab 17.3에서 require_personal_access_token_expiry가 도입되었습니다.
  • GitLab 17.4에서 receptive_cluster_agents_enabled가 도입되었습니다.
  • GitLab 17.6에서 allow_all_integrations와 allowed_integrations가 추가되었습니다.
  • GitLab 18.6에서 iframe_rendering_enabled, iframe_rendering_allowlist, iframe_rendering_allowlist_raw가 도입되었습니다.
  • GitLab 19.0에서 built_in_project_templates_enabled와 lock_built_in_project_templates_enabled가 use_built_in_project_templates_enabled라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 19.1에서 email_otp_enabled가 도입되었습니다.
  • GitLab 19.2에서 built_in_project_templates_enabled와 lock_built_in_project_templates_enabled가 일반 공급되었습니다. 기능 플래그 use_built_in_project_templates_enabled는 제거되었습니다.
  • GitLab 19.2에서 require_sha_for_merge와 lock_require_sha_for_merge가 도입되었습니다.
  • GitLab 19.2에서 sidekiq_timezone_override가 도입되었습니다.
  • GitLab 19.4에서 concurrent_pull_request_import_jobs_limit가 도입되어, Bitbucket Server(50)와 GitHub(200) 임포터에 하드코딩되어 있던 제한을 기본값 200으로 통일했습니다.
  • GitLab 19.4에서 tags_create_limit가 도입되었습니다.
  • GitLab 19.4에서 audit_events_api_limit가 도입되었습니다.
  • GitLab 19.4에서 block_jwt_for_reclaimed_paths가 도입되었습니다.

일반적으로 모든 설정은 선택 사항입니다. 일부 설정을 활성화할 때는 관련된 다른 설정도 함께 구성해야 할 수 있습니다. 이러한 요구 사항은 아래 표의 Required(필수) 칼럼에 정리되어 있습니다.

속성 유형 필수 설명
admin_mode boolean no 관리 작업 시 재인증을 통해 관리자가 Admin Mode를 활성화하도록 요구합니다.
admin_notification_email string no 사용 중단: 대신 abuse_notification_email을 사용합니다. 설정하면 악용 신고가 이 주소로 전송됩니다. 악용 신고는 Admin 영역에서 항상 확인할 수 있습니다.
abuse_notification_email string no 설정하면 악용 신고가 이 주소로 전송됩니다. 악용 신고는 Admin 영역에서 항상 확인할 수 있습니다.
notify_on_unknown_sign_in boolean no 알 수 없는 IP 주소에서 로그인이 발생하면 알림을 전송합니다.
after_sign_out_path string no 로그아웃 후 사용자를 리디렉션할 위치입니다.
email_restrictions_enabled boolean no 새 사용자가 이메일로 계정을 생성하지 못하도록 차단합니다.
email_restrictions string required by: email_restrictions_enabled 가입 시 사용된 이메일을 검사하는 정규 표현식입니다.
after_sign_up_text string no 가입 후 사용자에게 표시되는 텍스트입니다.
ai_action_api_rate_limit integer no 사용자당 8시간마다 aiAction GraphQL 뮤테이션에 허용되는 최대 요청 수입니다. 기본값: 160. 속도 제한을 해제하려면 0으로 설정합니다.
akismet_api_key string required by: akismet_enabled Akismet 스팸 방지용 API 키입니다.
akismet_enabled boolean no (활성화 시 필요: akismet_api_key) Akismet 스팸 방지를 활성화하거나 비활성화합니다.
allow_all_integrations boolean no false 이면 allowed_integrations에 있는 통합만 인스턴스에서 허용됩니다. Ultimate 전용입니다.
allowed_integrations array of strings no allow_all_integrations가 false 이면 이 목록에 있는 통합만 인스턴스에서 허용됩니다. Ultimate 전용입니다.
allow_account_deletion boolean no 사용자가 자신의 계정을 삭제할 수 있도록 허용하려면 true로 설정합니다. Premium 및 Ultimate 전용입니다.
allow_group_owners_to_manage_ldap boolean no 그룹 Owner가 LDAP를 관리할 수 있도록 허용하려면 true로 설정합니다. Premium 및 Ultimate 전용입니다.
allow_local_requests_from_hooks_and_services boolean no (사용 중단: 대신 allow_local_requests_from_web_hooks_and_services를 사용합니다) 웹훅과 통합에서 로컬 네트워크로의 요청을 허용합니다.
allow_local_requests_from_system_hooks boolean no 시스템 훅에서 로컬 네트워크로의 요청을 허용합니다.
allow_local_requests_from_web_hooks_and_services boolean no 웹훅과 통합에서 로컬 네트워크로의 요청을 허용합니다.
allow_project_creation_for_guest_and_below boolean no Guest 권한 이하가 할당된 사용자가 그룹과 개인 프로젝트를 생성할 수 있는지 여부입니다. 기본값은 true 입니다.
allow_runner_registration_token boolean no 등록 토큰으로 러너를 생성하도록 허용합니다. 기본값은 true 입니다.
archive_builds_in_human_readable string no job을 오래된 것으로 간주해 만료 처리할 기간을 설정합니다. 이 기간이 지나면 job은 아카이브되어 다시 실행할 수 없습니다. job을 만료하지 않으려면 비워 둡니다. 1일 이상이어야 하며, 예를 들어 15 days, 1 month, 2 years와 같이 지정합니다.
asset_proxy_enabled boolean no (활성화 시 필요: asset_proxy_url) 에셋 프록시를 활성화합니다. 변경 사항을 적용하려면 GitLab을 재시작해야 합니다.
asset_proxy_secret_key string no 에셋 프록시 서버와 공유하는 시크릿입니다. 변경 사항을 적용하려면 GitLab을 재시작해야 합니다.
asset_proxy_url string no 에셋 프록시 서버의 URL 입니다. 변경 사항을 적용하려면 GitLab을 재시작해야 합니다.
asset_proxy_whitelist string or array of strings no (사용 중단: 대신 asset_proxy_allowlist를 사용합니다) 이 도메인과 일치하는 에셋은 프록시를 거치지 않습니다. 와일드카드를 사용할 수 있습니다. 설치한 GitLab의 URL은 자동으로 허용 목록에 포함됩니다. 변경 사항을 적용하려면 GitLab을 재시작해야 합니다.
asset_proxy_allowlist string or array of strings no 이 도메인과 일치하는 에셋은 프록시를 거치지 않습니다. 와일드카드를 사용할 수 있습니다. 설치한 GitLab의 URL은 자동으로 허용 목록에 포함됩니다. 변경 사항을 적용하려면 GitLab을 재시작해야 합니다.
audit_events_api_limit integer no 사용자당 1분간 인스턴스 감사 이벤트 API에 허용되는 최대 요청 수입니다. 기본값: 200. 속도 제한을 해제하려면 0으로 설정합니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. GitLab 19.4에서 도입되었습니다.
authn_data_retention_cleanup_enabled boolean no true 이면 1년이 지난 인증 로그인 기록과, 한 달이 지난 폐기된 OAuth 액세스 토큰 및 권한 부여를 영구 삭제하는 정리 워커를 실행합니다. 기본값: false. GitLab 18.7에서 도입되었습니다.
authorized_keys_enabled boolean no 기본적으로 authorized_keys 파일은 추가 설정 없이 SSH 기반 Git을 지원합니다. GitLab은 데이터베이스 파일로 SSH 키를 인증하도록 최적화할 수 있습니다. OpenSSH 서버에 AuthorizedKeysCommand를 설정한 경우에만 이 설정을 비활성화합니다.
auto_accept_awarded_achievements boolean no true 이면 새로 부여된 업적이 자동으로 수락되어 사용자 프로필에 즉시 표시됩니다. 이 설정을 활성화하기 전에 부여된 업적에는 영향을 주지 않습니다. 수신자는 업적을 숨길 수 있습니다. 기본값: false. GitLab 19.4에서 도입되었습니다.
auto_devops_domain string no 모든 프로젝트의 Auto Review Apps 및 Auto Deploy Stage에서 기본으로 사용할 도메인을 지정합니다.
auto_devops_enabled boolean no 프로젝트에 Auto DevOps를 기본으로 활성화합니다. 사전 정의된 CI/CD 구성을 기준으로 애플리케이션을 자동으로 빌드, 테스트, 배포합니다.
autocomplete_users integer no GET /autocomplete/users 엔드포인트에 대한 분당 최대 인증 요청 수입니다.
autocomplete_users_unauthenticated integer no GET /autocomplete/users 엔드포인트에 대한 분당 최대 비인증 요청 수입니다.
automatic_purchased_storage_allocation boolean no 활성화하면 네임스페이스에서 구매한 스토리지가 자동으로 할당됩니다. EE 배포판에만 해당합니다.
bulk_import_enabled boolean no 직접 전송 방식의 GitLab 그룹 마이그레이션을 활성화합니다. 이 설정은 Admin 영역에서도 사용할 수 있습니다.
offline_transfer_exports_enabled boolean no 오프라인 전송 방식으로 GitLab 그룹과 프로젝트를 내보낼 수 있도록 활성화합니다. GitLab 19.3에서 도입되었습니다.
offline_transfer_imports_enabled boolean no 오프라인 전송 방식으로 GitLab 그룹과 프로젝트를 가져올 수 있도록 활성화합니다. GitLab 19.3에서 도입되었습니다.
bulk_import_max_download_file_size integer no 직접 전송 방식으로 소스 GitLab 인스턴스에서 가져올 때의 최대 다운로드 파일 크기입니다.
allow_bypass_placeholder_confirmation boolean no 관리자가 플레이스홀더 사용자를 재할당할 때 확인 절차를 건너뜁니다. GitLab 18.0에서 도입되었습니다.
allow_s3_compatible_storage_for_offline_transfer boolean no 오프라인 전송에 S3 호환 오브젝트 스토리지를 허용합니다. GitLab 18.9에서 도입되었습니다.
allow_application_default_credentials_for_offline_transfer boolean no 오프라인 전송에 Google Cloud Application Default Credentials를 허용합니다. 활성화하더라도 관리자만 이 자격 증명을 사용할 수 있으며, 버킷 이름은 gitlab-offline-transfer-로 시작해야 합니다. GitLab.com에는 영향을 주지 않습니다. 자세한 내용은 오프라인 전송에 애플리케이션 기본 자격 증명 허용을 참고합니다. GitLab 19.3에서 도입되었습니다.
built_in_project_templates_enabled boolean no 사용자가 프로젝트를 생성할 때 기본 제공 프로젝트 템플릿을 사용할 수 있도록 활성화합니다. Premium 및 Ultimate 전용입니다. GitLab 19.0에서 use_built_in_project_templates_enabled라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. GitLab 19.2에서 일반 공급되었습니다. 기능 플래그 use_built_in_project_templates_enabled는 제거되었습니다.
lock_built_in_project_templates_enabled boolean no 모든 그룹에 built_in_project_templates_enabled 설정을 강제합니다. Premium 및 Ultimate 전용입니다. GitLab 19.0에서 use_built_in_project_templates_enabled라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. GitLab 19.2에서 일반 공급되었습니다. 기능 플래그 use_built_in_project_templates_enabled는 제거되었습니다.
can_create_group boolean no 사용자가 최상위 그룹을 생성할 수 있는지 여부입니다. 기본값은 true 입니다.
check_namespace_plan boolean no 활성화하면 프로젝트 네임스페이스의 플랜에 해당 기능이 포함되어 있거나 프로젝트가 공개인 경우에만 라이선스가 있는 EE 기능을 사용할 수 있습니다. Premium 및 Ultimate 전용입니다.
ci_delete_pipelines_in_seconds_limit_human_readable string no 파이프라인 보존 기간에 설정할 수 있는 최댓값입니다. 기본값은 1 year 입니다.
ci_job_live_trace_enabled boolean no job 로그의 증분 로깅을 켭니다. 켜면 아카이브된 job 로그가 오브젝트 스토리지에 증분 방식으로 업로드됩니다. 오브젝트 스토리지를 먼저 구성해야 합니다. 이 설정은 Admin 영역에서도 구성할 수 있습니다.
git_push_pipeline_limit integer no 한 번의 Git 푸시로 트리거할 수 있는 태그 또는 브랜치 파이프라인의 최대 개수를 설정합니다. 이 제한에 대한 자세한 내용은 Git 푸시당 파이프라인 수를 참고합니다.
ci_max_total_yaml_size_bytes integer no 포함된 모든 YAML 구성 파일을 합쳐 파이프라인 구성에 할당할 수 있는 최대 메모리 크기(바이트)입니다.
ci_max_includes integer no 파이프라인당 최대 include 개수입니다. 기본값은 150 입니다.
ci_partitions_size_limit integer no 새 파티션을 생성하기 전에 CI 테이블의 데이터베이스 파티션이 사용할 수 있는 최대 디스크 공간(바이트)입니다. 기본값은 100 GB 입니다. GitLab 18.11에서 제거되었습니다.
ci_partitions_in_seconds_limit_human_readable string no 새 CI 파티션을 생성하고 다음 파티션 집합으로 전환하기까지의 기간입니다. 1 month에서 6 months 사이여야 합니다. 기본값은 1 month 입니다.
ci_partitions_in_seconds_limit integer no 새 CI 파티션을 생성하고 다음 파티션 집합으로 전환하기까지의 기간(초)입니다. 1개월에서 6개월 사이여야 합니다. 기본값은 1개월(2592000)입니다. 쓰기 전용이며 GET 응답에는 반환되지 않습니다. ci_partitions_in_seconds_limit_human_readable로 대체되어 사용 중단되었으며 API v5에서 제거될 예정입니다.
code_dropdown_custom_clients array of hashes no 프로젝트의 Code 드롭다운 목록에 표시되는 사용자 지정 "Open with" 클라이언트입니다. 각 항목에는 name과, {url}을 정확히 한 번 포함하는 ssh_url_template 또는 http_url_template 중 하나 이상이 있어야 합니다. custom_code_dropdown_clients 기능 플래그가 활성화된 경우에만 사용할 수 있습니다.
concurrent_github_import_jobs_limit integer no GitHub 임포터의 최대 동시 가져오기 job 수입니다. 기본값은 1000 입니다.
concurrent_bitbucket_import_jobs_limit integer no Bitbucket Cloud 임포터의 최대 동시 가져오기 job 수입니다. 기본값은 100 입니다.
concurrent_bitbucket_server_import_jobs_limit integer no Bitbucket Server 임포터의 최대 동시 가져오기 job 수입니다. 기본값은 100 입니다.
concurrent_pull_request_import_jobs_limit integer no GitHub, Bitbucket Cloud, Bitbucket Server 임포터의 최대 동시 풀 리퀘스트 가져오기 job 수입니다. 기본값은 200 입니다.
import_jobs_concurrency_limit integer no 가져오기 워커 유형별(프로젝트 및 그룹 파일 기반 가져오기, 직접 전송, GitHub·Bitbucket Cloud·Bitbucket Server 임포터 Stage)로 동시에 실행할 수 있는 최대 job 수입니다. 워커 유형마다 따로 적용됩니다. 기본값은 100 입니다. GitLab 19.1에서 도입되었습니다.
commit_email_hostname string no 커스텀 호스트 이름입니다(비공개 커밋 이메일용).
container_expiration_policies_enable_historic_entries boolean no 모든 프로젝트에 정리 정책을 활성화합니다.
container_registry_cleanup_tags_service_max_list_size integer no 정리 정책을 한 번 실행할 때 삭제할 수 있는 최대 태그 수입니다.
container_registry_delete_tags_service_timeout integer no 정리 정책에서 태그 한 묶음을 삭제하는 데 허용되는 최대 시간(초)입니다.
container_registry_expiration_policies_caching boolean no 정리 정책 실행 중 캐시 사용 여부입니다.
container_registry_expiration_policies_worker_capacity integer no 정리 정책에 사용할 워커 수입니다.
container_registry_token_expire_delay integer no 컨테이너 레지스트리 토큰의 유효 기간(분)입니다.
package_registry_cleanup_policies_worker_capacity integer no 패키지 정리 정책에 할당되는 워커 수입니다.
updating_name_disabled_for_users boolean no 사용자 프로필 이름 변경을 비활성화합니다.
deactivate_dormant_users boolean no 휴면 사용자 자동 비활성화를 활성화합니다.
deactivate_dormant_users_period integer no 사용자를 휴면으로 간주하기까지의 기간(일)입니다.
decompress_archive_file_timeout integer no 아카이브 파일 압축 해제의 기본 타임아웃(초)입니다. 타임아웃을 해제하려면 0으로 설정합니다.
default_artifacts_expire_in string no 각 job 아티팩트의 기본 만료 시간을 설정합니다.
default_branch_name string no 인스턴스의 모든 프로젝트에 대해 초기 브랜치 이름을 설정합니다.
default_branch_protection integer no GitLab 17.0에서 사용 중단되었습니다. 대신 default_branch_protection_defaults를 사용합니다.
default_branch_protection_defaults hash no GitLab 17.0에서 도입되었습니다. 사용할 수 있는 옵션은 default_branch_protection_defaults 옵션을 참고합니다.
default_ci_config_path string no 새 프로젝트의 기본 CI/CD 구성 파일과 경로입니다(설정하지 않으면 .gitlab-ci.yml).
default_group_visibility string no 새 그룹에 적용되는 공개 범위입니다. private, internal, public을 파라미터로 받을 수 있습니다. 기본값은 private 입니다. restricted_visibility_levels에 지정된 수준으로는 설정할 수 없습니다.
default_preferred_language string no 로그인하지 않은 사용자의 기본 선호 언어입니다.
default_project_creation integer no 프로젝트 생성에 필요한 기본 최소 권한입니다. 0 (No one), 1 (Maintainers), 2 (Developers), 3 (Administrators), 4 (Owners) 중 하나를 받을 수 있습니다.
default_project_visibility string no 새 프로젝트에 적용되는 공개 범위입니다. private, internal, public을 파라미터로 받을 수 있습니다. 기본값은 private 입니다. restricted_visibility_levels에 지정된 수준으로는 설정할 수 없습니다.
default_projects_limit integer no 사용자당 프로젝트 제한입니다. 기본값은 100000 입니다.
default_snippet_visibility string no 새 스니펫에 적용되는 공개 범위입니다. private, internal, public을 파라미터로 받을 수 있습니다. 기본값은 private 입니다.
default_syntax_highlighting_theme integer no 신규 사용자와 로그인하지 않은 사용자에게 적용되는 기본 구문 강조 테마입니다. 사용할 수 있는 테마의 ID를 참고합니다.
default_dark_syntax_highlighting_theme integer no 신규 사용자와 로그인하지 않은 사용자에게 적용되는 다크 모드 기본 구문 강조 테마입니다. 사용할 수 있는 테마의 ID를 참고합니다.
default_project_deletion_protection boolean no 기본 프로젝트 삭제 보호를 활성화하여 관리자만 프로젝트를 삭제할 수 있게 합니다. 기본값은 false 입니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
delete_unconfirmed_users boolean no 이메일을 확인하지 않은 사용자를 삭제할지 여부를 지정합니다. 기본값은 false 입니다. true로 설정하면 미확인 사용자는 unconfirmed_users_delete_after_days 일 후에 삭제됩니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
deletion_adjourned_period integer no 삭제 예정으로 표시된 프로젝트 또는 그룹을 삭제하기까지 대기하는 일수입니다. 값은 1에서 90 사이여야 합니다. 기본값은 30 입니다.
dependency_management_settings hash no 의존성 관리 설정입니다. Sidekiq 전체에서 동시에 실행되는 보안 업데이트 스케줄러 job 수를 제한하려면 security_update_scheduler_max_concurrency(정수)를 설정합니다. 기본값: 30. 상한은 200 입니다. 스케줄링을 일시 중지하려면 0으로 설정합니다. Ultimate 전용입니다. GitLab 19.1에서 도입되었습니다.
description_and_note_max_size integer no 작업 항목, 머지 리퀘스트, 취약점의 설명 및 댓글 내용의 최대 크기(바이트)입니다. 기본값은 1048576 입니다.
diagramsnet_enabled boolean no (활성화하려면 diagramsnet_url 이 필요합니다) Diagrams.net 통합을 활성화합니다. 기본값은 true 입니다.
diagramsnet_url string required by: diagramsnet_enabled 통합에 사용할 Diagrams.net 인스턴스 URL 입니다.
diff_max_patch_bytes integer no 최대 diff 패치 크기(바이트)입니다.
diff_max_files integer no diff의 최대 파일 수입니다.
diff_max_lines integer no diff의 최대 줄 수입니다.
diff_max_versions integer no 머지 리퀘스트당 최대 diff 버전 수입니다.
diff_max_commits integer no 머지 리퀘스트당 최대 diff 커밋 수입니다.
disable_admin_oauth_scopes boolean no 관리자가 api, read_api, read_repository, write_repository, read_registry, write_registry, sudo 스코프를 가진 신뢰되지 않은 OAuth 2.0 애플리케이션에 GitLab 계정을 연결하지 못하도록 막습니다.
disable_feed_token boolean no RSS/Atom 및 캘린더 피드 토큰 표시를 비활성화합니다.
disable_personal_access_tokens boolean no 개인 액세스 토큰을 비활성화합니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. API를 통해 비활성화한 개인 액세스 토큰을 다시 활성화하는 방법은 없습니다. 이는 알려진 이슈입니다. 사용할 수 있는 우회 방법은 우회 방법을 참고합니다.
block_jwt_for_reclaimed_paths boolean no 이전에 사용된 네임스페이스 경로를 다시 확보한 프로젝트에 대해 CI/CD JWT 및 OIDC 토큰 생성을 차단합니다. 기본값은 true(제한 활성화)입니다. 네임스페이스 재확보로 인한 인증 우회 위험을 이해하고 감수하는 경우에만 비활성화합니다. GitLab Self-Managed 및 GitLab Dedicated 전용입니다.
disabled_oauth_sign_in_sources array of strings no 비활성화된 OAuth 로그인 소스입니다.
disable_password_authentication_for_users_with_sso_identities boolean no SSO ID가 있는 사용자에 대해 웹 인터페이스의 비밀번호 인증을 비활성화합니다. HTTP(S) 기반 Git 작업에는 영향을 주지 않습니다. 기본값은 false 입니다.
dns_rebinding_protection_enabled boolean no DNS 리바인딩 공격 방어를 강제합니다.
domain_denylist_enabled boolean no (활성화 시 필요: domain_denylist) 특정 도메인 이메일로 새 사용자 계정이 생성되는 것을 차단합니다.
domain_denylist array of strings no 이 도메인과 일치하는 이메일 주소를 가진 사용자는 새 계정을 만들 수 없습니다. 와일드카드를 사용할 수 있습니다. 여러 항목은 줄을 나누어 입력합니다. 예를 들어 domain.com, *.domain.com과 같이 지정합니다.
domain_allowlist array of strings no 계정 생성 시 회사 이메일만 사용하도록 강제합니다. 기본값은 null 이며 제한이 없음을 의미합니다.
downstream_pipeline_trigger_limit_per_project_user_sha integer no 최대 다운스트림 파이프라인 트리거 속도입니다. 기본값: 0(제한 없음).
dsa_key_restriction integer no 업로드할 수 있는 DSA 키의 최소 비트 길이입니다. 기본값은 0(제한 없음)입니다. -1은 DSA 키를 비활성화합니다.
ecdsa_key_restriction integer no 업로드할 수 있는 ECDSA 키의 최소 커브 크기(비트)입니다. 기본값은 0(제한 없음)입니다. -1은 ECDSA 키를 비활성화합니다.
ecdsa_sk_key_restriction integer no 업로드할 수 있는 ECDSA_SK 키의 최소 커브 크기(비트)입니다. 기본값은 0(제한 없음)입니다. -1은 ECDSA_SK 키를 비활성화합니다.
ed25519_key_restriction integer no 업로드할 수 있는 ED25519 키의 최소 커브 크기(비트)입니다. 기본값은 0(제한 없음)입니다. -1은 ED25519 키를 비활성화합니다.
ed25519_sk_key_restriction integer no 업로드할 수 있는 ED25519_SK 키의 최소 커브 크기(비트)입니다. 기본값은 0(제한 없음)입니다. -1은 ED25519_SK 키를 비활성화합니다.
eks_access_key_id string no AWS IAM 액세스 키 ID 입니다.
eks_account_id string no Amazon 계정 ID 입니다.
eks_integration_enabled boolean no Amazon EKS 통합을 활성화합니다.
eks_secret_access_key string no AWS IAM 시크릿 액세스 키입니다.
elasticsearch_aws_access_key string no AWS IAM 액세스 키입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_aws_region string no Elasticsearch 도메인이 구성된 AWS 리전입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_aws_secret_access_key string no AWS IAM 시크릿 액세스 키입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_aws boolean no AWS 호스팅 Elasticsearch 사용을 활성화합니다. Premium 및 Ultimate 전용입니다.
elasticsearch_client_adapter string no Elasticsearch Ruby 클라이언트가 사용하는 Faraday 어댑터입니다. 기본값은 typhoeus 입니다. 사용할 수 있는 값은 typhoeus와 net_http 입니다. GitLab 18.5에서 도입되었습니다. Premium 및 Ultimate 전용입니다.
elasticsearch_indexed_field_length_limit integer no Elasticsearch가 인덱싱하는 텍스트 필드의 최대 크기입니다. 값이 0 이면 제한이 없습니다. 리포지터리와 위키 인덱싱에는 적용되지 않습니다. Premium 및 Ultimate 전용입니다.
elasticsearch_indexed_file_size_limit_kb integer no Elasticsearch가 인덱싱하는 리포지터리 및 위키 파일의 최대 크기입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_indexing boolean no 고급 검색을 위한 인덱싱을 켭니다. Premium 및 Ultimate 전용입니다.
elasticsearch_requeue_workers boolean no 인덱싱 워커의 자동 재큐잉을 활성화합니다. 모든 문서가 처리될 때까지 Sidekiq job을 큐에 넣어 코드 외 인덱싱 처리량을 높입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_limit_indexing boolean no Elasticsearch가 특정 네임스페이스와 프로젝트만 인덱싱하도록 제한합니다. Premium 및 Ultimate 전용입니다.
elasticsearch_max_bulk_concurrency integer no 인덱싱 작업당 Elasticsearch 벌크 요청의 최대 동시 실행 수입니다. 리포지터리 인덱싱 작업에만 적용됩니다. Premium 및 Ultimate 전용입니다.
elasticsearch_max_code_indexing_concurrency integer no Elasticsearch 코드 인덱싱 백그라운드 job의 최대 동시 실행 수입니다. 리포지터리 인덱싱 작업에만 적용됩니다. Premium 및 Ultimate 전용입니다.
elasticsearch_worker_number_of_shards integer no 인덱싱 워커 샤드 수입니다. 병렬 Sidekiq job을 더 많이 큐에 넣어 코드 외 인덱싱 처리량을 높입니다. 기본값은 2 입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_max_bulk_size_mb integer no Elasticsearch 벌크 인덱싱 요청의 최대 크기(MB)입니다. 리포지터리 인덱싱 작업에만 적용됩니다. Premium 및 Ultimate 전용입니다.
elasticsearch_namespace_ids array of integers no elasticsearch_limit_indexing 이 활성화된 경우 Elasticsearch로 인덱싱할 네임스페이스입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_project_ids array of integers no elasticsearch_limit_indexing 이 활성화된 경우 Elasticsearch로 인덱싱할 프로젝트입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_search boolean no Elasticsearch 검색을 활성화합니다. Premium 및 Ultimate 전용입니다.
elasticsearch_url string or array of strings no Elasticsearch에 연결할 때 사용할 URL 입니다. 클러스터를 지원하려면 쉼표로 구분한 목록이나 배열을 사용합니다(예: http://localhost:9200, http://localhost:9201 또는 ["http://localhost:9200", "http://localhost:9201"]). Premium 및 Ultimate 전용입니다.
elasticsearch_username string no Elasticsearch 인스턴스의 username 입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_password string no Elasticsearch 인스턴스의 비밀번호입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_prefix string no Elasticsearch 인덱스 이름에 붙일 커스텀 접두사입니다. 기본값은 gitlab 입니다. 1~100자여야 하고 소문자 영숫자, 하이픈, 밑줄만 사용할 수 있으며 하이픈이나 밑줄로 시작하거나 끝날 수 없습니다. Premium 및 Ultimate 전용입니다.
elasticsearch_retry_on_failure integer no Elasticsearch 검색 요청의 최대 재시도 횟수입니다. Premium 및 Ultimate 전용입니다.
elasticsearch_shards integer or object Yes, if elasticsearch_replicas is defined as an object Elasticsearch 인덱스의 샤드 수입니다. 모든 인덱스에 같은 값을 적용하려면 정수를 사용하고, 인덱스별로 값을 지정하려면 객체를 사용합니다. 예: {"gitlab-production": 5, "gitlab-production-notes": 3}.
객체를 사용할 때는 각 인덱스에 elasticsearch_shards와 elasticsearch_replicas를 모두 지정해야 합니다. 어느 한 값이라도 빠지면 해당 인덱스는 건너뜁니다. Premium 및 Ultimate 전용입니다.
elasticsearch_replicas integer or object Yes, if elasticsearch_shards is defined as an object Elasticsearch 인덱스의 복제본 수입니다. 모든 인덱스에 같은 값을 적용하려면 정수를 사용하고, 인덱스별로 값을 지정하려면 객체를 사용합니다. 예: {"gitlab-production": 1, "gitlab-production-notes": 2}.
객체를 사용할 때는 각 인덱스에 elasticsearch_shards와 elasticsearch_replicas를 모두 지정해야 합니다. 어느 한 값이라도 빠지면 해당 인덱스는 건너뜁니다. Premium 및 Ultimate 전용입니다.
email_additional_text string no 법률·감사·컴플라이언스 목적으로 모든 이메일 하단에 추가되는 텍스트입니다. Premium 및 Ultimate 전용입니다.
email_author_in_body boolean no 일부 메일 서버는 발신자 이름 재정의를 지원하지 않습니다. 이 옵션을 활성화하면 이슈, 머지 리퀘스트, 댓글 작성자의 이름이 이메일 본문에 포함됩니다.
email_confirmation_setting string no 로그인 전에 이메일을 확인해야 하는지 지정합니다. 사용할 수 있는 값은 off, soft, hard 입니다.
email_otp_enabled boolean no 이메일 기반 일회용 비밀번호(OTP)를 다중 인증 방식으로 활성화합니다. 기본적으로 비활성화되어 있습니다. require_email_verification_on_account_locked가 true 여야 합니다.
custom_http_clone_url_root string no HTTP(S) 용 커스텀 Git 클론 URL을 설정합니다.
enabled_git_access_protocol string no Git 접근에 허용되는 프로토콜입니다. 허용되는 값은 ssh, http, 두 프로토콜을 모두 허용하는 all 입니다.
enforce_namespace_storage_limit boolean no 활성화하면 네임스페이스 스토리지 제한을 강제할 수 있습니다.
enforce_terms boolean no (활성화 시 필요: terms) 모든 사용자에게 애플리케이션 이용약관을 강제합니다.
external_auth_client_cert string no (활성화 시 필요: external_auth_client_key) 외부 인가 서비스 인증에 사용할 인증서입니다.
external_auth_client_key_pass string no 외부 서비스 인증 시 개인 키에 사용할 암호이며, 저장할 때 암호화됩니다.
external_auth_client_key string required by: external_auth_client_cert 외부 인가 서비스에 인증이 필요할 때 사용하는 인증서의 개인 키이며, 저장할 때 암호화됩니다.
external_authorization_service_default_label string required by:
external_authorization_service_enabled		 인가를 요청할 때 프로젝트에 분류 레이블이 지정되어 있지 않은 경우 사용할 기본 분류 레이블입니다.
external_authorization_service_enabled boolean no (활성화 시 필요: external_authorization_service_default_label, external_authorization_service_timeout, external_authorization_service_url) 프로젝트 접근에 외부 인가 서비스를 사용하도록 활성화합니다.
external_authorization_service_timeout float required by:
external_authorization_service_enabled		 인가 요청을 중단하기까지의 타임아웃(초)입니다. 요청이 타임아웃되면 사용자의 접근이 거부됩니다. (최소: 0.001, 최대: 10, 단위: 0.001)
external_authorization_service_url string required by:
external_authorization_service_enabled		 인가 요청을 보낼 URL 입니다.
external_pipeline_validation_service_url string no 파이프라인 검증 요청에 사용할 URL 입니다.
external_pipeline_validation_service_token string no 선택 사항입니다. external_pipeline_validation_service_url의 URL로 요청할 때 X-Gitlab-Token 헤더에 포함할 토큰입니다.
external_pipeline_validation_service_timeout integer no 파이프라인 검증 서비스의 응답을 기다리는 시간입니다. 타임아웃되면 OK로 간주합니다.
static_objects_external_storage_url string no 리포지터리 정적 오브젝트용 외부 스토리지의 URL 입니다.
static_objects_external_storage_auth_token string required by: static_objects_external_storage_url static_objects_external_storage_url에 연결된 외부 스토리지의 인증 토큰입니다.
failed_login_attempts_unlock_period_in_minutes integer no 로그인 실패 횟수가 최대치에 도달한 사용자의 잠금이 해제되기까지의 기간(분)입니다.
file_template_project_id integer no 커스텀 파일 템플릿을 불러올 프로젝트의 ID 입니다. Premium 및 Ultimate 전용입니다.
first_day_of_week integer no 캘린더 보기와 날짜 선택기에서 한 주의 시작 요일입니다. 사용할 수 있는 값은 일요일은 0(기본값), 월요일은 1, 토요일은 6 입니다.
globally_allowed_ips string no 인바운드 트래픽에 항상 허용되는 IP 주소와 CIDR을 쉼표로 구분한 목록입니다. 예: 1.1.1.1, 2.2.2.0/24.
geo_node_allowed_ips string yes 허용되는 보조 노드의 IP와 CIDR을 쉼표로 구분한 목록입니다. 예: 1.1.1.1, 2.2.2.0/24. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
geo_status_timeout integer no 보조 노드 상태 조회 요청이 타임아웃되기까지의 시간(초)입니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
git_two_factor_session_expiry integer no 2FA가 활성화된 경우 Git 작업 세션의 최대 지속 시간(분)입니다. Premium 및 Ultimate 전용입니다.
gitaly_timeout_default integer no 기본 Gitaly 타임아웃(초)입니다. 이 타임아웃은 Git fetch/push 작업이나 Sidekiq job에는 적용되지 않습니다. 타임아웃을 해제하려면 0으로 설정합니다.
gitaly_timeout_fast integer no Gitaly 빠른 작업의 타임아웃(초)입니다. 일부 Gitaly 작업은 빠르게 끝나야 합니다. 이 임곗값을 넘으면 스토리지 샤드에 문제가 있을 수 있으며, 빠르게 실패시키면 GitLab 인스턴스의 안정성을 유지하는 데 도움이 됩니다. 타임아웃을 해제하려면 0으로 설정합니다.
gitaly_timeout_medium integer no 중간 수준 Gitaly 타임아웃(초)입니다. 빠른 작업 타임아웃과 기본 타임아웃 사이의 값이어야 합니다. 타임아웃을 해제하려면 0으로 설정합니다.
gitlab_dedicated_instance boolean no 인스턴스가 GitLab Dedicated 용으로 프로비저닝되었는지 여부입니다.
gitlab_environment_toolkit_instance boolean no Service Ping 보고를 위해 인스턴스가 GitLab Environment Toolkit으로 프로비저닝되었는지 여부입니다.
gitlab_shell_operation_limit integer no 사용자가 1분간 수행할 수 있는 최대 Git 작업 수입니다. 기본값: 600.
grafana_enabled boolean no Grafana를 활성화합니다.
grafana_url string no Grafana URL 입니다.
gravatar_enabled boolean no Gravatar를 활성화합니다.
group_owners_can_manage_default_branch_protection boolean no 기본 브랜치 보호의 재정의를 막습니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
hashed_storage_enabled boolean no 해시 스토리지 경로로 새 프로젝트를 생성합니다. 변경되지 않는 해시 기반 경로와 리포지터리 이름으로 디스크에 리포지터리를 저장합니다. 이렇게 하면 프로젝트 URL 이 바뀌어도 리포지터리를 옮기거나 이름을 바꿀 필요가 없고 디스크 I/O 성능이 좋아질 수 있습니다. (GitLab 13.0 이상에서는 항상 활성화되며, 이 구성은 14.0에서 제거될 예정입니다)
help_page_hide_commercial_content boolean no 도움말에서 마케팅 관련 항목을 숨깁니다.
help_page_support_url string no 도움말 페이지와 도움말 드롭다운 목록에 사용할 대체 지원 URL 입니다.
help_page_documentation_base_url string no 대체 문서 페이지 URL 입니다.
help_page_text string no 도움말 페이지에 표시되는 커스텀 텍스트입니다.
hide_third_party_offers boolean no GitLab에 서드파티 제안을 표시하지 않습니다.
home_page_url string no 로그인하지 않은 경우 이 URL로 리디렉션합니다.
housekeeping_bitmaps_enabled boolean no 사용 중단되었습니다. Git 팩파일 비트맵 생성은 항상 활성화되어 있으며 API와 UI로 변경할 수 없습니다. 항상 true를 반환합니다.
housekeeping_enabled boolean no Git 하우스키핑을 활성화하거나 비활성화합니다. 추가 필드를 설정해야 합니다.
housekeeping_full_repack_period integer no 사용 중단되었습니다. 증분 git repack을 실행하기까지의 Git 푸시 횟수입니다. 대신 housekeeping_optimize_repository_period를 사용합니다.
housekeeping_gc_period integer no 사용 중단되었습니다. git gc를 실행하기까지의 Git 푸시 횟수입니다. 대신 housekeeping_optimize_repository_period를 사용합니다.
housekeeping_incremental_repack_period integer no 사용 중단되었습니다. 증분 git repack을 실행하기까지의 Git 푸시 횟수입니다. 대신 housekeeping_optimize_repository_period를 사용합니다.
housekeeping_optimize_repository_period integer no 증분 git repack을 실행하기까지의 Git 푸시 횟수입니다.
html_emails_enabled boolean no HTML 이메일을 활성화합니다.
import_sources array of strings no 프로젝트 가져오기를 허용할 소스입니다. 사용할 수 있는 값은 github, bitbucket, bitbucket_server, fogbugz, git, gitlab_project, gitea, manifest 입니다.
invisible_captcha_enabled boolean no 계정 생성 시 Invisible CAPTCHA 스팸 탐지를 활성화합니다. 기본적으로 비활성화되어 있습니다.
issues_create_limit integer no 사용자당 분당 최대 이슈 생성 요청 수입니다. 기본적으로 비활성화되어 있습니다.
jira_connect_application_key string no GitLab for Jira Cloud 앱 인증에 사용하는 OAuth 애플리케이션의 ID 입니다.
jira_connect_public_key_storage_enabled boolean no GitLab for Jira Cloud 앱의 공개 키 저장을 활성화합니다.
jira_connect_proxy_url string no GitLab for Jira Cloud 앱의 프록시로 사용되는 GitLab 인스턴스의 URL 입니다.
keep_latest_artifact boolean no 만료 시간과 관계없이 가장 최근 성공한 job의 아티팩트가 삭제되지 않도록 합니다. 기본적으로 활성화되어 있습니다.
local_markdown_version integer no 캐시된 Markdown을 무효화해야 할 때 이 값을 올립니다.
lock_memberships_to_saml boolean no SAML 그룹 멤버십 전역 잠금을 강제합니다.
mailgun_signing_key string no 웹훅에서 이벤트를 수신할 때 사용하는 Mailgun HTTP 웹훅 서명 키입니다.
mailgun_events_enabled boolean no Mailgun 이벤트 수신기를 활성화합니다.
maintenance_mode_message string no 인스턴스가 유지 보수 모드일 때 표시되는 메시지입니다. Premium 및 Ultimate 전용입니다.
maintenance_mode boolean no 인스턴스가 유지 보수 모드이면 관리자가 아닌 사용자는 읽기 전용으로 로그인하고 읽기 전용 API 요청을 보낼 수 있습니다. Premium 및 Ultimate 전용입니다.
max_artifacts_size integer no 최대 아티팩트 크기(MB)입니다.
max_attachment_size integer no 첨부 파일 크기 제한(MB)입니다.
max_decompressed_archive_size integer no 가져온 아카이브의 최대 압축 해제 파일 크기(MB)입니다. 무제한으로 하려면 0으로 설정합니다. 기본값은 25600 입니다.
max_export_size integer no 최대 내보내기 크기(MB)입니다. 0 이면 무제한입니다. 기본값은 0(무제한)입니다.
max_github_response_size_limit integer no 허용되는 GitHub API 응답의 최대 크기(MB)입니다. 0 이면 무제한입니다.
max_github_response_json_value_count integer no GitHub API 응답에서 허용되는 최대 값 개수입니다. 0 이면 무제한입니다. 개수는 응답에 포함된 :, ,, {, [의 등장 횟수를 기준으로 추정합니다.
max_http_decompressed_size integer no 아웃바운드 요청에서 받은 Gzip 압축 HTTP 응답의 압축 해제 후 허용되는 최대 크기(MiB)입니다. 0 이면 무제한입니다.
max_http_response_json_depth integer no 아웃바운드 요청에서 받은 JSON HTTP 응답에 허용되는 최대 중첩 깊이입니다.
max_http_response_json_structural_chars integer no 아웃바운드 요청에서 받은 JSON HTTP 응답에 허용되는 최대 객체 수입니다. 개수는 응답에 포함된 :, ,, {, [의 등장 횟수를 기준으로 추정합니다. GitLab 18.4에서 도입되었습니다.
max_http_response_xml_structural_chars integer no 아웃바운드 요청에서 받은 XML HTTP 응답에 허용되는 최대 객체 수입니다. 개수는 응답에 포함된 <와 =의 등장 횟수를 기준으로 추정합니다. GitLab 18.4에서 도입되었습니다.
max_http_response_csv_structural_chars integer no 아웃바운드 요청에서 받은 CSV HTTP 응답에 허용되는 최대 객체 수입니다. 개수는 응답에 포함된 ,, ;, \t, \n의 등장 횟수를 기준으로 추정합니다. GitLab 18.4에서 도입되었습니다.
max_http_response_size_limit integer no 아웃바운드 요청에서 받은 HTTP 응답에 허용되는 최대 크기(MiB)입니다. 0 이면 무제한입니다. 통합, 임포터, 웹훅에 적용됩니다. GitLab 18.4에서 도입되었습니다.
max_import_size integer no 최대 가져오기 크기(MB)입니다. 0 이면 무제한입니다. 기본값은 0(무제한)입니다.
max_import_remote_file_size integer no 외부 오브젝트 스토리지에서 가져올 때의 최대 원격 파일 크기입니다.
max_login_attempts integer no 사용자를 잠그기까지 허용되는 최대 로그인 시도 횟수입니다.
max_pages_size integer no Pages 리포지터리의 최대 크기(MB)입니다.
max_personal_access_token_lifetime integer no 액세스 토큰에 허용되는 최대 수명(일)입니다. 비워 두면 기본값 365가 적용됩니다. 설정할 경우 값은 365 이하여야 합니다. 값을 변경하면 최대 허용 수명을 넘는 만료일을 가진 기존 액세스 토큰은 폐기됩니다. GitLab Self-Managed의 Ultimate 전용입니다. GitLab 17.6 이상에서는 buffered_token_expiration_limit라는 기능 플래그를 활성화해 최대 수명 제한을 400일까지 연장할 수 있습니다.
max_ssh_key_lifetime integer no SSH 키에 허용되는 최대 수명(일)입니다. GitLab Self-Managed의 Ultimate 전용입니다. GitLab 17.6 이상에서는 buffered_token_expiration_limit라는 기능 플래그를 활성화해 최대 수명 제한을 400일까지 연장할 수 있습니다.
max_terraform_state_size_bytes integer no Terraform 상태 파일의 최대 크기(바이트)입니다. 파일 크기를 무제한으로 하려면 0으로 설정합니다.
metrics_method_call_threshold integer no 메서드 호출은 지정한 밀리초보다 오래 걸릴 때만 추적됩니다.
max_number_of_repository_downloads integer no 사용자가 차단되기 전 지정한 기간 동안 다운로드할 수 있는 고유 리포지터리의 최대 개수입니다. 기본값: 0, 최대: 10,000개. GitLab Self-Managed의 Ultimate 전용입니다.
max_number_of_repository_downloads_within_time_period integer no 보고 기간(초)입니다. 기본값: 0, 최대: 864000초(10일). GitLab Self-Managed의 Ultimate 전용입니다.
max_yaml_depth integer no include 키워드로 추가한 중첩 CI/CD 구성의 최대 깊이입니다. 기본값: 100.
max_yaml_size_bytes integer no 단일 CI/CD 구성 파일의 최대 크기(바이트)입니다. 기본값: 2097152.
git_rate_limit_users_allowlist array of strings no Git 악용 방지 속도 제한에서 제외되는 사용자 이름 목록입니다. 기본값: [], 최대: 사용자 이름 100개. GitLab Self-Managed의 Ultimate 전용입니다.
git_rate_limit_users_alertlist array of integers no Git 악용 속도 제한을 초과했을 때 이메일을 받는 사용자 ID 목록입니다. 기본값: [], 최대: 사용자 ID 100개. GitLab Self-Managed의 Ultimate 전용입니다.
auto_ban_user_on_excessive_projects_download boolean no 활성화하면 max_number_of_repository_downloads와 max_number_of_repository_downloads_within_time_period로 지정한 기간 동안 최대 고유 프로젝트 수를 초과해 다운로드한 사용자는 애플리케이션에서 자동으로 차단됩니다. GitLab Self-Managed의 Ultimate 전용입니다.
mirror_available boolean no 프로젝트 Maintainer가 리포지터리 미러링을 구성하도록 허용합니다. 비활성화하면 관리자만 리포지터리 미러링을 구성할 수 있습니다.
mirror_capacity_threshold integer no 미러를 선제적으로 추가 예약하기 전에 확보해야 하는 최소 용량입니다. Premium 및 Ultimate 전용입니다.
mirror_max_capacity integer no 동시에 동기화할 수 있는 최대 미러 수입니다. Premium 및 Ultimate 전용입니다.
mirror_max_delay integer no 동기화가 예약된 미러의 업데이트 간 최대 간격(분)입니다. Premium 및 Ultimate 전용입니다.
maven_package_requests_forwarding boolean no Maven 패키지를 GitLab 패키지 레지스트리에서 찾지 못한 경우 repo.maven.apache.org를 기본 원격 리포지터리로 사용합니다. Premium 및 Ultimate 전용입니다.
npm_package_requests_forwarding boolean no npm 패키지를 GitLab 패키지 레지스트리에서 찾지 못한 경우 npmjs.org를 기본 원격 리포지터리로 사용합니다. Premium 및 Ultimate 전용입니다.
pypi_package_requests_forwarding boolean no PyPI 패키지를 GitLab 패키지 레지스트리에서 찾지 못한 경우 pypi.org를 기본 원격 리포지터리로 사용합니다. Premium 및 Ultimate 전용입니다.
rubygems_package_requests_forwarding boolean no RubyGems 패키지를 GitLab 패키지 레지스트리에서 찾지 못한 경우 rubygems.org를 기본 원격 리포지터리로 사용합니다. Premium 및 Ultimate 전용입니다.
oauth_access_token_expires_in integer no 인스턴스가 발급하는 모든 새 OAuth 액세스 토큰의 최대 수명(초)입니다. 최솟값: 300(5분). 기본값: 7200(2시간). 비어 있거나 null 이면 기본값을 사용합니다. 기존 OAuth 액세스 토큰에는 영향을 주지 않습니다.
outbound_local_requests_whitelist array of strings no 웹훅과 통합의 로컬 요청이 비활성화된 경우에도 로컬 요청을 허용할 신뢰 도메인 또는 IP 주소 목록을 정의합니다. 현재 이 속성은 업데이트할 수 없습니다. 자세한 내용은 이슈 569729를 참고합니다.
package_registry_allow_anyone_to_pull_option boolean no 패키지 레지스트리에서 누구나 가져오기 허용 설정을 표시하고 변경할 수 있게 합니다.
package_metadata_purl_types array of integers no 동기화할 패키지 레지스트리 메타데이터 목록입니다. 사용할 수 있는 값은 목록을 참고합니다. GitLab Self-Managed의 Ultimate 전용입니다.
pages_domain_verification_enabled boolean no 사용자가 커스텀 도메인의 소유권을 증명하도록 요구합니다. 도메인 검증은 공개 GitLab 사이트의 필수 보안 조치입니다. 사용자는 도메인이 활성화되기 전에 해당 도메인을 통제하고 있음을 증명해야 합니다.
pages_unique_domain_default_enabled boolean no 네임스페이스에 속한 사이트 간에 쿠키가 공유되지 않도록 Pages 사이트에 고유 도메인을 기본으로 활성화합니다. 기본값은 true 입니다.
password_authentication_enabled_for_git boolean no GitLab 계정 비밀번호로 HTTP(S) 기반 Git 인증을 활성화합니다. 기본값은 true 입니다.
password_authentication_enabled_for_web boolean no GitLab 계정 비밀번호로 웹 인터페이스 인증을 활성화합니다. 기본값은 true 입니다.
minimum_password_length integer no 비밀번호에 최소 길이를 요구하는지 여부입니다. Premium 및 Ultimate 전용입니다.
password_number_required boolean no 비밀번호에 숫자를 하나 이상 요구하는지 여부입니다. Premium 및 Ultimate 전용입니다.
password_symbol_required boolean no 비밀번호에 기호 문자를 하나 이상 요구하는지 여부입니다. Premium 및 Ultimate 전용입니다.
password_uppercase_required boolean no 비밀번호에 대문자를 하나 이상 요구하는지 여부입니다. Premium 및 Ultimate 전용입니다.
password_lowercase_required boolean no 비밀번호에 소문자를 하나 이상 요구하는지 여부입니다. Premium 및 Ultimate 전용입니다.
performance_bar_allowed_group_id string no (사용 중단: 대신 performance_bar_allowed_group_path를 사용합니다) 성능 바를 전환할 수 있는 그룹의 경로입니다.
performance_bar_allowed_group_path string no 성능 바를 전환할 수 있는 그룹의 경로입니다.
performance_bar_enabled boolean no (사용 중단: 대신 performance_bar_allowed_group_path: nil을 전달합니다) 성능 바를 활성화할 수 있게 합니다.
personal_access_token_prefix string no 생성되는 모든 개인 액세스 토큰에 붙는 접두사입니다.
pipeline_limit_per_project_user_sha integer no 사용자와 커밋별로 분당 최대 파이프라인 생성 요청 수입니다. 기본적으로 비활성화되어 있습니다.
pipeline_limit_per_user integer no 사용자당 분당 최대 파이프라인 생성 요청 수입니다.
ci_lint_limit_per_user integer no 사용자당 분당 최대 CI Lint 요청 수입니다. 기본적으로 비활성화되어 있습니다.
gitpod_enabled boolean no (활성화 시 필요: gitpod_url) Ona 통합을 활성화합니다. 기본값은 false 입니다.
gitpod_url string required by: gitpod_enabled 통합에 사용할 Ona 인스턴스 URL 입니다.
inactive_resource_access_tokens_delete_after_days integer no 비활성 프로젝트 및 그룹 액세스 토큰의 보존 기간을 지정합니다. 기본값은 30 입니다.
kroki_enabled boolean no (활성화 시 필요: kroki_url) Kroki 통합을 활성화합니다. 기본값은 false 입니다.
kroki_url string required by: kroki_enabled 통합에 사용할 Kroki 인스턴스 URL 입니다.
kroki_formats object no Kroki 인스턴스가 지원하는 추가 형식입니다. bpmn, blockdiag, excalidraw, mermaid 형식에 대해 <format>: true 또는 <format>: false 형태로 true 나 false를 지정할 수 있습니다.
kroki_diagram_proxy_enabled boolean no Kroki 다이어그램 프록시를 활성화합니다. 기본값은 false 입니다.
plantuml_enabled boolean no (활성화 시 필요: plantuml_url) PlantUML 통합을 활성화합니다. 기본값은 false 입니다.
plantuml_url string required by: plantuml_enabled 통합에 사용할 PlantUML 인스턴스 URL 입니다.
plantuml_diagram_proxy_enabled boolean no PlantUML 다이어그램 프록시를 활성화합니다. 기본값은 false 입니다.
polling_interval_multiplier float no 폴링을 수행하는 엔드포인트가 사용하는 간격 배수입니다. 폴링을 해제하려면 0으로 설정합니다.
project_export_enabled boolean no 프로젝트 내보내기를 활성화합니다.
project_jobs_api_rate_limit integer no /project/:id/jobs에 대한 분당 최대 인증 요청 수입니다. 기본값: 600.
projects_api_rate_limit_unauthenticated integer no 모든 프로젝트 조회 API에 대한 비인증 요청의 IP 주소당 10분간 최대 요청 수입니다. 기본값: 400. 제한을 해제하려면 0으로 설정합니다.
runner_jobs_request_api_limit integer no /jobs/request 러너 job API 엔드포인트에 대한 러너 토큰당 분당 최대 요청 수입니다. 기본값: 2000. 제한을 해제하려면 0으로 설정합니다. GitLab 18.5에서 도입되었습니다.
runner_jobs_patch_trace_api_limit integer no PATCH /jobs/:id/trace 러너 job API 엔드포인트에 대한 러너 토큰당 분당 최대 요청 수입니다. 기본값: 2000. 제한을 해제하려면 0으로 설정합니다. GitLab 18.5에서 도입되었습니다.
runner_jobs_endpoints_api_limit integer no 러너 job API 엔드포인트의 /jobs/* 요청에 대한 job 토큰당 분당 최대 요청 수입니다. 기본값: 200. 제한을 해제하려면 0으로 설정합니다. GitLab 18.5에서 도입되었습니다.
users_api_limit_following integer no 사용자 또는 IP 주소당 분당 최대 요청 수입니다. 기본값: 100. 제한을 해제하려면 0으로 설정합니다. GitLab 17.10에서 도입되었습니다.
users_api_limit_followers integer no 사용자 또는 IP 주소당 분당 최대 요청 수입니다. 기본값: 100. 제한을 해제하려면 0으로 설정합니다. GitLab 17.10에서 도입되었습니다.
users_api_limit_status integer no 사용자 또는 IP 주소당 분당 최대 요청 수입니다. 기본값: 240. 제한을 해제하려면 0으로 설정합니다. GitLab 17.10에서 도입되었습니다.
users_api_limit_keys integer no 사용자 또는 IP 주소당 분당 최대 요청 수입니다. 기본값: 120. 제한을 해제하려면 0으로 설정합니다. GitLab 17.10에서 도입되었습니다.
users_api_limit_key integer no 사용자 또는 IP 주소당 분당 최대 요청 수입니다. 기본값: 120. 제한을 해제하려면 0으로 설정합니다. GitLab 17.10에서 도입되었습니다.
users_api_limit_gpg_keys integer no 사용자 또는 IP 주소당 분당 최대 요청 수입니다. 기본값: 120. 제한을 해제하려면 0으로 설정합니다. GitLab 17.10에서 도입되었습니다.
users_api_limit_gpg_key integer no 사용자 또는 IP 주소당 분당 최대 요청 수입니다. 기본값: 120. 제한을 해제하려면 0으로 설정합니다. GitLab 17.10에서 도입되었습니다.
virtual_registries_endpoints_api_limit integer no 가상 레지스트리 엔드포인트에 대한 IP 주소당 15초간 최대 요청 수입니다. 기본값: 4000. 제한을 해제하려면 0으로 설정합니다. GitLab 17.11에서 도입되었습니다.
project_secrets_limit integer no Secrets Manager에서 프로젝트당 허용되는 최대 시크릿 수입니다. 기본값: 100. 제한을 해제하려면 0으로 설정합니다. Ultimate 전용입니다. GitLab 18.9에서 도입되었습니다.
group_secrets_limit integer no Secrets Manager에서 그룹당 허용되는 최대 시크릿 수입니다. 기본값: 500. 제한을 해제하려면 0으로 설정합니다. Ultimate 전용입니다. GitLab 18.9에서 도입되었습니다.
prometheus_metrics_enabled boolean no Prometheus 메트릭을 활성화합니다.
protected_ci_variables boolean no CI/CD 변수를 기본적으로 보호합니다.
disable_overriding_approvers_per_merge_request boolean no 프로젝트와 머지 리퀘스트에서 승인 규칙을 편집하지 못하도록 막습니다
prevent_merge_requests_author_approval boolean no 머지 리퀘스트 생성자(작성자)의 승인을 막습니다
prevent_merge_requests_committers_approval boolean no 머지 리퀘스트에 커밋한 사람의 승인을 막습니다
push_event_activities_limit integer no 한 번의 푸시에서 대량 푸시 이벤트가 생성되는 기준이 되는 최대 변경(브랜치 또는 태그) 수입니다. 0으로 설정해도 제한이 해제되지는 않습니다.
push_event_hooks_limit integer no 한 번의 푸시에서 웹훅과 통합이 트리거되지 않는 기준이 되는 최대 변경(브랜치 또는 태그) 수입니다. 0으로 설정해도 제한이 해제되지는 않습니다. 기본값: 3.
rate_limiting_response_text string no throttle_* 설정으로 속도 제한을 활성화한 경우, 속도 제한을 초과하면 이 일반 텍스트 응답을 보냅니다. 비워 두면 'Retry later' 가 전송됩니다.
raw_blob_request_limit integer no raw 경로별 분당 최대 요청 수입니다(기본값은 300). 제한을 해제하려면 0으로 설정합니다.
raw_blob_request_limit_unauthenticated integer no 프로젝트의 모든 raw 경로를 합친 분당 최대 비인증 요청 수입니다(기본값은 800). 제한을 해제하려면 0으로 설정합니다.
search_rate_limit integer no 인증된 상태에서 검색을 수행할 때의 분당 최대 요청 수입니다. 기본값: 30. 제한을 해제하려면 0으로 설정합니다.
search_rate_limit_unauthenticated integer no 인증되지 않은 상태에서 검색을 수행할 때의 분당 최대 요청 수입니다. 기본값: 10. 제한을 해제하려면 0으로 설정합니다.
recaptcha_enabled boolean no (활성화 시 필요: recaptcha_private_key와 recaptcha_site_key) reCAPTCHA를 활성화합니다.
login_recaptcha_protection_enabled boolean no 로그인에 reCAPTCHA를 활성화합니다.
recaptcha_private_key string required by: recaptcha_enabled reCAPTCHA의 개인 키입니다.
recaptcha_site_key string required by: recaptcha_enabled reCAPTCHA의 사이트 키입니다.
receptive_cluster_agents_enabled boolean no Kubernetes 용 GitLab 에이전트의 수신 모드를 활성화합니다.
receive_max_input_size integer no 최대 푸시 크기(MB)입니다.
relation_export_batch_size integer no 배치 관계를 내보낼 때 각 배치의 크기입니다. GitLab 18.2에서 도입되었습니다.
remember_me_enabled boolean no Remember me 설정을 활성화합니다.
repository_checks_enabled boolean no GitLab은 디스크 손상 문제를 조용히 넘기지 않도록 모든 프로젝트와 위키 리포지터리에서 주기적으로 git fsck를 실행합니다.
repository_size_limit integer no 리포지터리당 크기 제한(MB)입니다. Premium 및 Ultimate 전용입니다.
repository_storages_weighted hash of strings to integers no gitlab.yml에서 가져온 이름과 가중치의 해시입니다. 새 프로젝트는 가중치 기반 무작위 선택으로 이 스토어 중 하나에 생성됩니다.
require_admin_approval_after_user_signup boolean no 활성화하면 가입 양식으로 계정을 만든 사용자는 Pending approval 상태가 되며, 관리자가 명시적으로 승인해야 합니다.
require_email_verification_on_account_locked boolean no true 이면 의심스러운 로그인 활동이 감지된 후 인스턴스의 모든 사용자가 본인 인증을 해야 합니다.
require_personal_access_token_expiry boolean no 활성화하면 사용자는 그룹 또는 프로젝트 액세스 토큰이나, 서비스 계정이 아닌 사용자가 소유한 개인 액세스 토큰을 생성할 때 만료일을 설정해야 합니다.
require_sha_for_merge boolean no 머지 리퀘스트 머지 엔드포인트 호출에 유효한 커밋 sha를 요구하는 인스턴스 기본값입니다. GitLab 19.2에서 도입되었습니다.
lock_require_sha_for_merge boolean no 인스턴스의 모든 그룹에 require_sha_for_merge 설정을 강제합니다. GitLab 19.2에서 도입되었습니다.
require_two_factor_authentication boolean no (활성화 시 필요: two_factor_grace_period) 모든 사용자에게 2단계 인증 설정을 요구합니다.
resource_usage_limits hash no Sidekiq 워커에 적용되는 리소스 사용량 제한의 정의입니다. 이 설정은 GitLab.com 에서만 사용할 수 있습니다.
restricted_visibility_levels array of strings no 선택한 수준은 관리자가 아닌 사용자가 그룹, 프로젝트, 스니펫에 사용할 수 없습니다. private, internal, public을 파라미터로 받을 수 있습니다. 기본값은 null 이며 제한이 없음을 의미합니다. default_project_visibility와 default_group_visibility로 설정된 수준은 선택할 수 없습니다.
rsa_key_restriction integer no 업로드할 수 있는 RSA 키의 최소 비트 길이입니다. 기본값은 0(제한 없음)입니다. -1은 RSA 키를 비활성화합니다.
session_expire_delay integer no 세션 지속 시간(분)입니다. 변경 사항을 적용하려면 GitLab을 재시작해야 합니다.
session_expire_from_init boolean no true 이면 마지막 활동 이후가 아니라 세션이 생성된 후 일정 시간이 지나면 세션이 만료됩니다. 이 세션 수명은 session_expire_delay로 정의합니다.
security_policy_global_group_approvers_enabled boolean no 머지 리퀘스트 승인 정책의 승인 그룹을 전역에서 찾을지, 프로젝트 계층 안에서 찾을지 여부입니다.
security_approval_policies_limit integer no 보안 정책 프로젝트당 활성 머지 리퀘스트 승인 정책의 최대 개수입니다. 기본값: 5. 최대: 20
scan_execution_policies_action_limit integer no 스캔 실행 정책당 actions의 최대 개수입니다. 기본값: 0. 최대: 20
scan_execution_policies_schedule_limit integer no 스캔 실행 정책당 type: schedule 규칙의 최대 개수입니다. 기본값: 0. 최대: 20
security_txt_content string no 공개 보안 연락처 정보입니다.
security_mr_report_cache_lifetime_minutes integer no 머지 리퀘스트의 보안 리포트를 캐시하는 시간(분)입니다(10~60). 기본값: 10. Premium 및 Ultimate 전용입니다. GitLab 18.10에서 도입되었습니다.
security_scan_stale_after_days integer no 보안 스캔 데이터를 삭제하기 전에 보관하는 일수입니다. 7일에서 90일 사이여야 합니다. 기본값: GitLab.com은 30일, GitLab Self-Managed는 90일. Premium 및 Ultimate 전용입니다. GitLab 18.9에서 도입되었습니다.
service_access_tokens_expiration_enforced boolean no 서비스 계정 사용자의 토큰 만료일을 선택 사항으로 둘 수 있는지 나타내는 플래그입니다. Premium 및 Ultimate 전용입니다.
shared_runners_enabled boolean no (활성화 시 필요: shared_runners_text와 shared_runners_minutes) 새 프로젝트에 인스턴스 러너를 활성화합니다.
shared_runners_minutes integer required by: shared_runners_enabled 그룹이 인스턴스 러너에서 월간 사용할 수 있는 최대 컴퓨팅 분을 설정합니다. Premium 및 Ultimate 전용입니다.
shared_runners_text string required by: shared_runners_enabled 인스턴스 러너 안내 문구입니다.
runner_token_expiration_interval integer no 새로 등록되는 인스턴스 러너의 인증 토큰 만료 시간(초)을 설정합니다. 최솟값은 7200초입니다. 자세한 내용은 인증 토큰 자동 교체를 참고합니다.
group_runner_token_expiration_interval integer no 새로 등록되는 그룹 러너의 인증 토큰 만료 시간(초)을 설정합니다. 최솟값은 7200초입니다. 자세한 내용은 인증 토큰 자동 교체를 참고합니다.
project_runner_token_expiration_interval integer no 새로 등록되는 프로젝트 러너의 인증 토큰 만료 시간(초)을 설정합니다. 최솟값은 7200초입니다. 자세한 내용은 인증 토큰 자동 교체를 참고합니다.
sidekiq_job_limiter_mode string no track 또는 compress 입니다. Sidekiq job 크기 제한의 동작을 설정합니다. 기본값: 'compress'.
sidekiq_job_limiter_compression_threshold_bytes integer no Sidekiq job을 Redis에 저장하기 전에 압축하는 기준 크기(바이트)입니다. 기본값: 100,000바이트(100 KB).
sidekiq_job_limiter_limit_bytes integer no Sidekiq job을 거부하는 기준 크기(바이트)입니다. 기본값: 0바이트(어떤 job도 거부하지 않음).
sidekiq_timezone_override string no 모든 Sidekiq cron job에 적용되는 IANA 시간대 식별자입니다(예: America/Chicago). 비워 두면 재정의가 적용되지 않고 cron job은 Rails 애플리케이션 시간대를 사용합니다.
signin_enabled string no (사용 중단: 대신 password_authentication_enabled_for_web을 사용합니다) 웹 인터페이스에 비밀번호 인증이 활성화되어 있는지 나타내는 플래그입니다.
sign_in_restrictions hash no 애플리케이션 로그인 제한입니다.
signup_enabled boolean no 가입을 활성화합니다. 기본값은 true 입니다.
silent_admin_exports_enabled boolean no 관리자 무음 내보내기를 활성화합니다. 기본값은 false 입니다.
silent_mode_enabled boolean no 무음 모드를 활성화합니다. 기본값은 false 입니다.
slack_app_enabled boolean no (활성화 시 필요: slack_app_id, slack_app_secret, slack_app_signing_secret, slack_app_verification_token) GitLab for Slack 앱을 활성화합니다.
slack_app_id string required by: slack_app_enabled GitLab for Slack 앱의 클라이언트 ID 입니다.
slack_app_secret string required by: slack_app_enabled GitLab for Slack 앱의 클라이언트 시크릿입니다. 앱에서 오는 OAuth 요청을 인증하는 데 사용합니다.
slack_app_signing_secret string required by: slack_app_enabled GitLab for Slack 앱의 서명 시크릿입니다. 앱에서 오는 API 요청을 인증하는 데 사용합니다.
slack_app_verification_token string required by: slack_app_enabled GitLab for Slack 앱의 검증 토큰입니다. 이 인증 방식은 Slack에서 사용 중단되었으며 앱의 슬래시 명령 인증에만 사용됩니다.
snippet_size_limit integer no 스니펫 내용의 최대 크기(바이트)입니다. 기본값: 52428800바이트(50 MB).
snowplow_app_id string no Snowplow 사이트 이름 또는 애플리케이션 ID 입니다. (예: gitlab)
snowplow_collector_hostname string required by: snowplow_enabled Snowplow 컬렉터 호스트 이름입니다. (예: your-snowplow-collector.example.com)
snowplow_database_collector_hostname string no 데이터베이스 이벤트용 Snowplow 컬렉터의 호스트 이름입니다. (예: your-db-snowplow-collector.example.com)
snowplow_cookie_domain string no Snowplow 쿠키 도메인입니다. (예: .gitlab.com)
snowplow_enabled boolean no Snowplow 추적을 활성화합니다.
sourcegraph_enabled boolean no Sourcegraph 통합을 활성화합니다. 기본값은 false 입니다. 활성화하려면 sourcegraph_url 이 필요합니다.
sourcegraph_public_only boolean no 비공개 및 내부 프로젝트에서 Sourcegraph가 로드되지 않도록 막습니다. 기본값은 true 입니다.
sourcegraph_url string required by: sourcegraph_enabled 통합에 사용할 Sourcegraph 인스턴스 URL 입니다.
spam_check_endpoint_enabled boolean no 외부 Spam Check API 엔드포인트를 사용한 스팸 검사를 활성화합니다. 기본값은 false 입니다.
spam_check_endpoint_url string no 외부 Spamcheck 서비스 엔드포인트의 URL 입니다. 사용할 수 있는 URI 스킴은 grpc 또는 tls 입니다. tls를 지정하면 통신이 암호화됩니다.
spam_check_api_key string no GitLab 이 Spam Check 서비스 엔드포인트에 접근할 때 사용하는 API 키입니다.
enable_artifact_external_redirect_warning_page boolean no GitLab Pages의 사용자 생성 콘텐츠에 대해 경고하는 외부 리디렉션 페이지를 표시합니다.
tags_create_limit integer no 프로젝트당 30분간 허용되는 최대 태그 생성 요청 수입니다. 태그를 생성하는 REST API 엔드포인트, GraphQL tagCreate 뮤테이션, UI의 태그 생성, /tag 퀵 액션에 적용됩니다. 기본값: 100. 속도 제한을 해제하려면 0으로 설정합니다.
terminal_max_session_time integer no 웹 터미널 웹소켓 연결의 최대 시간(초)입니다. 시간을 무제한으로 하려면 0으로 설정합니다.
terms text required by: enforce_terms (다음 설정에 필요: enforce_terms) 이용약관의 Markdown 콘텐츠입니다.
throttle_authenticated_api_enabled boolean no (활성화 시 필요: throttle_authenticated_api_period_in_seconds와 throttle_authenticated_api_requests_per_period) 인증된 API 요청의 속도 제한을 활성화합니다. 크롤러나 악성 봇 등에서 오는 요청량을 줄이는 데 도움이 됩니다.
throttle_authenticated_api_period_in_seconds integer required by:
throttle_authenticated_api_enabled		 속도 제한 기간(초)입니다.
throttle_authenticated_api_requests_per_period integer required by:
throttle_authenticated_api_enabled		 사용자당 기간별 최대 요청 수입니다.
throttle_authenticated_dependency_proxy_enabled boolean conditionally true 이면 인증된 의존성 프록시 요청의 속도 제한을 적용합니다. 기본값: false.
throttle_authenticated_dependency_proxy_period_in_seconds integer no 속도 제한 기간(초)입니다. throttle_authenticated_dependency_proxy_enabled가 true 여야 합니다. 기본값: 15.
throttle_authenticated_dependency_proxy_requests_per_period integer no 사용자당 기간별 최대 요청 수입니다. throttle_authenticated_dependency_proxy_enabled가 true 여야 합니다. 기본값: 1000.
throttle_authenticated_git_http_enabled boolean conditionally true 이면 인증된 Git HTTP 요청의 속도 제한을 적용합니다. 기본값: false.
throttle_authenticated_git_http_period_in_seconds integer no 속도 제한 기간(초)입니다. throttle_authenticated_git_http_enabled가 true 여야 합니다. 기본값: 3600.
throttle_authenticated_git_http_requests_per_period integer no 사용자당 기간별 최대 요청 수입니다. throttle_authenticated_git_http_enabled가 true 여야 합니다. 기본값: 3600.
throttle_authenticated_packages_api_enabled boolean no (활성화 시 필요: throttle_authenticated_packages_api_period_in_seconds와 throttle_authenticated_packages_api_requests_per_period) 인증된 API 요청의 속도 제한을 활성화합니다. 크롤러나 악성 봇 등에서 오는 요청량을 줄이는 데 도움이 됩니다. 자세한 내용은 패키지 레지스트리 속도 제한을 참고합니다.
throttle_authenticated_packages_api_period_in_seconds integer required by:
throttle_authenticated_packages_api_enabled		 속도 제한 기간(초)입니다. 자세한 내용은 패키지 레지스트리 속도 제한을 참고합니다.
throttle_authenticated_packages_api_requests_per_period integer required by:
throttle_authenticated_packages_api_enabled		 사용자당 기간별 최대 요청 수입니다. 자세한 내용은 패키지 레지스트리 속도 제한을 참고합니다.
throttle_authenticated_web_enabled boolean no (활성화 시 필요: throttle_authenticated_web_period_in_seconds와 throttle_authenticated_web_requests_per_period) 인증된 웹 요청의 속도 제한을 활성화합니다. 크롤러나 악성 봇 등에서 오는 요청량을 줄이는 데 도움이 됩니다.
throttle_authenticated_web_period_in_seconds integer required by:
throttle_authenticated_web_enabled		 속도 제한 기간(초)입니다.
throttle_authenticated_web_requests_per_period integer required by:
throttle_authenticated_web_enabled		 사용자당 기간별 최대 요청 수입니다.
throttle_unauthenticated_enabled boolean no (GitLab 14.3에서 사용 중단되었습니다. 대신 throttle_unauthenticated_web_enabled 또는 throttle_unauthenticated_api_enabled를 사용합니다.) (활성화 시 필요: throttle_unauthenticated_period_in_seconds와 throttle_unauthenticated_requests_per_period) 인증되지 않은 웹 요청의 속도 제한을 활성화합니다. 크롤러나 악성 봇 등에서 오는 요청량을 줄이는 데 도움이 됩니다.
throttle_unauthenticated_period_in_seconds integer required by:
throttle_unauthenticated_enabled		 (GitLab 14.3에서 사용 중단되었습니다. 대신 throttle_unauthenticated_web_period_in_seconds 또는 throttle_unauthenticated_api_period_in_seconds를 사용합니다.) 속도 제한 기간(초)입니다.
throttle_unauthenticated_requests_per_period integer required by:
throttle_unauthenticated_enabled		 (GitLab 14.3에서 사용 중단되었습니다. 대신 throttle_unauthenticated_web_requests_per_period 또는 throttle_unauthenticated_api_requests_per_period를 사용합니다.) IP 당 기간별 최대 요청 수입니다.
throttle_unauthenticated_api_enabled boolean no (활성화 시 필요: throttle_unauthenticated_api_period_in_seconds와 throttle_unauthenticated_api_requests_per_period) 인증되지 않은 API 요청의 속도 제한을 활성화합니다. 크롤러나 악성 봇 등에서 오는 요청량을 줄이는 데 도움이 됩니다.
throttle_unauthenticated_api_period_in_seconds integer required by:
throttle_unauthenticated_api_enabled		 속도 제한 기간(초)입니다.
throttle_unauthenticated_api_requests_per_period integer required by:
throttle_unauthenticated_api_enabled		 IP 당 기간별 최대 요청 수입니다.
throttle_unauthenticated_git_http_enabled boolean conditionally true 이면 인증되지 않은 Git HTTP 요청의 속도 제한을 적용합니다. 기본값: false.
throttle_unauthenticated_git_http_period_in_seconds integer no 속도 제한 기간(초)입니다. throttle_unauthenticated_git_http_enabled가 true 여야 합니다. 기본값: 3600.
throttle_unauthenticated_git_http_requests_per_period integer no IP 당 기간별 최대 요청 수입니다. throttle_unauthenticated_git_http_enabled가 true 여야 합니다. 기본값: 3600.
throttle_unauthenticated_packages_api_enabled boolean no (활성화 시 필요: throttle_unauthenticated_packages_api_period_in_seconds와 throttle_unauthenticated_packages_api_requests_per_period) 인증되지 않은 API 요청의 속도 제한을 활성화합니다. 크롤러나 악성 봇 등에서 오는 요청량을 줄이는 데 도움이 됩니다. 자세한 내용은 패키지 레지스트리 속도 제한을 참고합니다.
throttle_unauthenticated_packages_api_period_in_seconds integer required by:
throttle_unauthenticated_packages_api_enabled		 속도 제한 기간(초)입니다. 자세한 내용은 패키지 레지스트리 속도 제한을 참고합니다.
throttle_unauthenticated_packages_api_requests_per_period integer required by:
throttle_unauthenticated_packages_api_enabled		 사용자당 기간별 최대 요청 수입니다. 자세한 내용은 패키지 레지스트리 속도 제한을 참고합니다.
throttle_unauthenticated_web_enabled boolean no (활성화 시 필요: throttle_unauthenticated_web_period_in_seconds와 throttle_unauthenticated_web_requests_per_period) 인증되지 않은 웹 요청의 속도 제한을 활성화합니다. 크롤러나 악성 봇 등에서 오는 요청량을 줄이는 데 도움이 됩니다.
throttle_unauthenticated_web_period_in_seconds integer required by:
throttle_unauthenticated_web_enabled		 속도 제한 기간(초)입니다.
throttle_unauthenticated_web_requests_per_period integer required by:
throttle_unauthenticated_web_enabled		 IP 당 기간별 최대 요청 수입니다.
time_tracking_limit_to_hours boolean no 시간 추적 단위를 시간 단위로만 표시하도록 제한합니다. 기본값은 false 입니다.
top_level_group_creation_enabled boolean no 사용자가 최상위 그룹을 생성할 수 있게 합니다. 기본값은 true 입니다.
two_factor_grace_period integer required by: require_two_factor_authentication 사용자가 2단계 인증의 강제 설정을 건너뛸 수 있는 시간(시간 단위)입니다.
unconfirmed_users_delete_after_days integer no 계정 생성 후 이메일을 확인하지 않은 사용자를 며칠 뒤에 삭제할지 지정합니다. delete_unconfirmed_users가 true 인 경우에만 적용됩니다. 1 이상이어야 합니다. 기본값은 7 입니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
unique_ips_limit_enabled boolean no (활성화 시 필요: unique_ips_limit_per_user와 unique_ips_limit_time_window) 여러 IP 에서의 로그인을 제한합니다.
unique_ips_limit_per_user integer required by: unique_ips_limit_enabled 사용자당 최대 IP 수입니다.
unique_ips_limit_time_window integer required by: unique_ips_limit_enabled IP가 제한 집계에 포함되는 시간(초)입니다.
update_runner_versions_enabled boolean no GitLab.com에서 GitLab Runner 릴리스 버전 데이터를 가져옵니다. 자세한 내용은 업그레이드가 필요한 러너 확인 방법을 참고합니다.
usage_ping_enabled boolean no GitLab은 매주 라이선스 사용량을 GitLab, Inc. 에 보고합니다.
gitlab_product_usage_data_enabled boolean no 제품 사용 데이터 수집이 활성화되어 있는지 여부입니다. GITLAB_PRODUCT_USAGE_DATA_ENABLED 환경 변수가 설정되어 있으면 API는 환경 변수의 적용값을 반환합니다.
gitlab_product_usage_data_source string no 읽기 전용입니다. gitlab_product_usage_data_enabled 설정의 출처를 나타냅니다. GITLAB_PRODUCT_USAGE_DATA_ENABLED 환경 변수가 설정되어 있으면 environment를, 그렇지 않으면 database를 반환합니다.
use_clickhouse_for_analytics boolean no 분석 리포트의 데이터 소스로 ClickHouse를 사용합니다. 이 설정이 적용되려면 ClickHouse가 구성되어 있어야 합니다. Premium 및 Ultimate 에서만 사용할 수 있습니다.
use_nats_for_audit_streaming boolean no 감사 이벤트 스트리밍을 NATS JetStream으로 전달합니다. 이 설정이 적용되려면 NATS가 구성되어 있어야 합니다. Premium 및 Ultimate 에서만 사용할 수 있습니다.
include_optional_metrics_in_service_ping boolean no Service Ping에서 선택 메트릭을 활성화할지 여부입니다.
user_deactivation_emails_enabled boolean no 계정 비활성화 시 사용자에게 이메일을 보냅니다.
user_default_external boolean no 새로 가입한 사용자를 기본적으로 외부 사용자로 지정합니다.
user_default_internal_regex string no 기본 내부 사용자를 식별할 이메일 주소 정규 표현식 패턴을 지정합니다.
user_defaults_to_private_profile boolean no 새로 생성된 사용자의 프로필을 기본적으로 비공개로 지정합니다. 기본값은 false 입니다.
user_oauth_applications boolean no 사용자가 GitLab을 OAuth 공급자로 사용하도록 애플리케이션을 등록할 수 있게 허용합니다. 이 설정은 그룹 수준 OAuth 애플리케이션에는 영향을 주지 않습니다.
user_show_add_ssh_key_message boolean no false로 설정하면 SSH 키를 업로드하지 않은 사용자에게 표시되는 You won't be able to pull or push repositories via SSH until you add an SSH key to your profile 경고가 비활성화됩니다.
version_check_enabled boolean no 업데이트가 있을 때 GitLab 이 알려주도록 합니다.
valid_runner_registrars array of strings no GitLab Runner를 등록할 수 있는 유형의 목록입니다. [], ['group'], ['project'], ['group', 'project'] 중 하나일 수 있습니다.
vscode_extension_marketplace hash no VS Code Extension Marketplace 설정입니다. Web IDE와 워크스페이스에서 사용합니다.
web_hook_event_resend_limit integer no 특정 프로젝트 또는 그룹에 대해 사용자당 분당 최대 웹훅 이벤트 재전송 요청 수입니다. 기본값: 5. 제한을 해제하려면 0으로 설정합니다. GitLab 19.3에서 도입되었습니다.
web_hook_test_limit integer no 특정 프로젝트 또는 그룹에 대해 사용자당 분당 최대 웹훅 테스트 요청 수입니다. 기본값: 5. 제한을 해제하려면 0으로 설정합니다. GitLab 19.3에서 도입되었습니다.
whats_new_variant string no What's new 표시 방식이며, 사용할 수 있는 값은 all_tiers, current_tier, disabled 입니다.
wiki_page_max_content_bytes integer no 위키 페이지 내용의 최대 크기(바이트)입니다. 기본값: 5242880바이트(5 MB). 최솟값은 1024바이트입니다.
bulk_import_concurrent_pipeline_batch_limit integer no 동시에 처리할 수 있는 최대 직접 전송 배치 내보내기 수입니다.
concurrent_relation_batch_export_limit integer no 동시에 처리할 수 있는 최대 배치 내보내기 job 수입니다. GitLab 17.6에서 도입되었습니다.
concurrent_relation_export_limit integer no 동시에 처리할 수 있는 최대 프로젝트 파일 내보내기 수입니다. 기본값: 25. GitLab 19.4에서 도입되었습니다.
asciidoc_max_includes integer no 한 문서에서 처리되는 AsciiDoc include 지시문의 최대 개수입니다. 기본값: 32. 최대: 64.
duo_custom_agents_enabled boolean no 이 인스턴스에서 커스텀 에이전트를 허용하는지 여부입니다. 기본값: true. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. GitLab 19.0에서 도입되었습니다.
duo_custom_flows_enabled boolean no 이 인스턴스에서 커스텀 플로를 허용하는지 여부입니다. 기본값: true. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. GitLab 19.0에서 도입되었습니다.
duo_external_agents_enabled boolean no 이 인스턴스에서 외부 에이전트를 허용하는지 여부입니다. 기본값: true. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. GitLab 19.0에서 도입되었습니다.
duo_features_enabled boolean no 이 인스턴스에서 GitLab Duo 기능이 활성화되어 있는지 여부입니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
lock_duo_custom_agents_enabled boolean no 커스텀 에이전트 활성화 설정을 모든 그룹에 강제하는지 여부입니다. 기본값: false. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. GitLab 19.0에서 도입되었습니다.
lock_duo_custom_flows_enabled boolean no 커스텀 플로 활성화 설정을 모든 그룹에 강제하는지 여부입니다. 기본값: false. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. GitLab 19.0에서 도입되었습니다.
lock_duo_external_agents_enabled boolean no 외부 에이전트 활성화 설정을 모든 그룹에 강제하는지 여부입니다. 기본값: false. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다. GitLab 19.0에서 도입되었습니다.
lock_duo_features_enabled boolean no GitLab Duo 기능 활성화 설정을 모든 하위 그룹에 강제하는지 여부입니다. GitLab Self-Managed의 Premium 및 Ultimate 전용입니다.
nuget_skip_metadata_url_validation boolean no NuGet 패키지의 메타데이터 URL 검증을 건너뛸지 여부입니다. GitLab 17.0에서 도입되었습니다.
helm_max_packages_count integer no 채널당 조회할 수 있는 최대 Helm 패키지 수입니다. 1 이상이어야 합니다. 기본값은 1000 입니다.
require_admin_two_factor_authentication boolean no 관리자가 인스턴스의 모든 관리자에게 2FA를 요구할 수 있게 허용합니다.
secret_push_protection_available boolean no 프로젝트가 시크릿 푸시 보호를 활성화할 수 있게 허용합니다. 이 설정 자체가 시크릿 푸시 보호를 켜지는 않습니다. Ultimate 전용입니다.
disable_invite_members boolean no 그룹의 멤버 초대 기능을 비활성화합니다.
enforce_pipl_compliance boolean no SaaS 애플리케이션에 PIPL 컴플라이언스를 강제할지 설정합니다
iframe_rendering_enabled boolean no Markdown에서 iframe 렌더링을 허용합니다. 기본적으로 비활성화되어 있습니다.
iframe_rendering_allowlist array of strings no 콘텐츠 보안 정책과 새니타이즈에 사용되는, 허용된 iframe src host[:port] 항목의 목록입니다.
iframe_rendering_allowlist_raw string no 허용된 iframe src host[:port] 항목을 줄바꿈 또는 쉼표로 구분한 원본 목록입니다.
usage_billing object no 사용량 청구 설정입니다. 스키마 정의는 ee/app/validators/json_schemas/usage_billing_settings.json을 참고합니다

휴면 프로젝트 설정#

휴면 프로젝트 삭제를 구성하거나 해제할 수 있습니다.

속성 유형 필수 설명
delete_inactive_projects boolean no 휴면 프로젝트 삭제를 활성화합니다. 기본값은 false 입니다.
inactive_projects_delete_after_months integer no delete_inactive_projects가 true 인 경우, 휴면 프로젝트를 삭제하기까지 대기하는 기간(개월)입니다. 기본값은 2 입니다.
inactive_projects_min_size_mb integer no delete_inactive_projects가 true 인 경우, 휴면 여부를 검사할 프로젝트의 최소 리포지터리 크기입니다. 기본값은 0 입니다.
inactive_projects_send_warning_email_after_months integer no delete_inactive_projects가 true 인 경우, 프로젝트가 휴면 상태여서 삭제 예정임을 Maintainer에게 이메일로 알리기까지 대기하는 기간(개월)을 설정합니다. 기본값은 1 입니다.

패키지 레지스트리 설정: 패키지 파일 크기 제한#

패키지 파일 크기 제한은 애플리케이션 설정 API에 포함되지 않습니다. 이 설정은 플랜 제한 API로 접근할 수 있습니다.

관련 주제#