설정을 업데이트하여 인스턴스의 모양과 느낌을 변경할 수 있습니다.

사전 요구사항#

관리자 접근 권한이 있어야 합니다.

외관 설정 접근#

Appearance 설정을 열려면:

1. 오른쪽 상단 모서리에서 Admin을 선택합니다.
2. Settings > Appearance를 선택합니다.

홈페이지 버튼 커스터마이즈#

홈페이지 버튼의 외관을 커스터마이즈합니다.

홈페이지 버튼은 왼쪽 사이드바의 왼쪽 상단 모서리에 위치합니다. 기본 GitLab 로고 [tanuki]를 다른 이미지로 교체합니다.

• 파일은 1MB 미만이어야 합니다.
• 이미지는 높이 24픽셀이어야 합니다. 높이가 24픽셀보다 큰 이미지는 자동으로 크기가 조정됩니다.

홈페이지 아이콘 이미지를 커스터마이즈하려면:

1. 오른쪽 상단 모서리에서 Admin을 선택합니다.
2. Settings > Appearance를 선택합니다.
3. Navigation bar 아래에서 Choose file을 선택합니다.
4. 페이지 하단에서 Update appearance settings를 선택합니다.

파이프라인 상태 이메일에도 커스텀 로고가 표시됩니다. 그러나 일부 이메일 애플리케이션은 SVG 이미지를 지원하지 않습니다. 커스텀 이미지가 SVG 형식인 경우 파이프라인 이메일에는 기본 로고가 표시됩니다.

파비콘 커스터마이즈#

파비콘의 외관을 커스터마이즈합니다. 파비콘은 브라우저 탭에 표시되는 웹사이트 아이콘입니다. GitLab 로고 [tanuki]는 기본 브라우저 및 CI/CD 상태 파비콘입니다. 기본 아이콘을 32 x 32 픽셀이고 .png 또는 .ico 형식의 이미지로 교체합니다.

파비콘을 변경하려면:

1. 오른쪽 상단 모서리에서 Admin을 선택합니다.
2. Settings > Appearance를 선택합니다.
3. Favicon 아래에서 Choose file을 선택합니다.
4. 페이지 하단에서 Update appearance settings를 선택합니다.

사이트 이름 커스터마이즈#

히스토리

• GitLab 18.11에서 도입되었습니다.

브라우저 탭의 페이지 제목에 자신만의 커스텀 사이트 이름을 추가할 수 있습니다. 예를 들어 사이트 이름이 MyCompany인 경우, 홈페이지에서 브라우저 탭의 페이지 제목은 Home · GitLab · MyCompany로 표시됩니다.

사이트 이름의 최대 길이는 255자입니다.

사이트 이름을 변경하려면:

1. 오른쪽 상단 모서리에서 Admin을 선택합니다.
2. Settings > Appearance를 선택합니다.
3. Site name 아래에 새 사이트 이름을 입력합니다.
4. 페이지 하단에서 Update appearance settings를 선택합니다.

시스템 헤더 및 푸터 메시지 추가#

히스토리

• Enable header and footer in emails 체크박스가 GitLab 15.9에서 도입되었습니다.

GitLab 인스턴스의 인터페이스에 작은 헤더 메시지, 작은 푸터 메시지 또는 둘 다를 추가합니다. 이 메시지는 로그인 및 등록 페이지와 같이 인스턴스의 모든 프로젝트와 페이지에 표시됩니다.

• Markdown으로 메시지에 이탤릭체, 볼드체, 또는 링크를 추가할 수 있습니다.
• 시스템 메시지는 단일 줄이어야 하므로 Markdown 목록, 이미지, 인용구는 지원되지 않습니다.

시스템 헤더, 푸터 메시지 또는 둘 다 추가하려면:

1. 오른쪽 상단 모서리에서 Admin을 선택합니다.
2. Settings > Appearance를 선택합니다.
3. System header and footer 섹션으로 이동합니다.
4. 필드를 작성합니다.
5. 선택 사항. Enable header and footer in emails 체크박스를 선택합니다. GitLab 인스턴스에서 보내는 모든 이메일에 시스템 메시지를 추가합니다.
6. 페이지 하단에서 Update appearance settings를 선택합니다.

기본적으로 시스템 헤더와 푸터 텍스트는 주황색 배경의 흰색 텍스트입니다. 메시지 색상을 커스터마이즈하려면:

• System header and footer 섹션으로 이동하여 Customize colors를 선택합니다.

로그인 및 등록 페이지 커스터마이즈#

로그인 및 등록 페이지의 제목, 설명, 로고를 커스터마이즈합니다. 기본적으로 등록 페이지 로고는 페이지 왼쪽, 제목과 설명 사이에 위치합니다.

로그인 및 등록 페이지 제목 또는 설명을 커스터마이즈하려면:

1. 오른쪽 상단 모서리에서 Admin을 선택합니다.
2. Settings > Appearance를 선택합니다.
3. Sign in/Sign up pages 섹션으로 이동합니다.
4. 필드를 작성합니다. Markdown으로 페이지 Title 및 Description을 형식화할 수 있습니다.
5. 페이지 하단에서 Update appearance settings를 선택합니다.

로그인 및 등록 페이지의 로고를 커스터마이즈하려면:

• 파일은 1MB 미만이어야 합니다.
• 이미지는 높이 128픽셀이어야 합니다. 높이가 128픽셀보다 큰 이미지는 자동으로 크기가 조정됩니다.

1. 오른쪽 상단 모서리에서 Admin을 선택합니다.
2. Settings > Appearance를 선택합니다.
3. Sign in/Sign up pages 섹션으로 이동합니다.
4. Logo 아래에서 Choose file을 선택합니다.
5. 페이지 하단에서 Update appearance settings를 선택합니다.

로그인 메시지 아래에 커스터마이즈된 도움말 메시지를 추가하거나 로그인 텍스트 메시지를 추가할 수도 있습니다.

쿠키 기반 언어 선택기 비활성화#

히스토리

• GitLab 16.10에서 도입되었습니다.

disable_preferred_language_cookie 기능 플래그를 활성화하여 로그인 및 등록 페이지 푸터에서 쿠키 기반 언어 선택기를 제거할 수 있습니다.

Progressive Web App 커스터마이즈#

히스토리

• GitLab 15.9에서 도입되었습니다.

Progressive Web App(PWA)의 아이콘, 표시 이름, 짧은 이름, 설명을 커스터마이즈합니다. 자세한 내용은 Progressive Web App을 참조하세요.

Progressive Web App 이름과 짧은 이름을 추가하려면:

1. 오른쪽 상단 모서리에서 Admin을 선택합니다.
2. Settings > Appearance를 선택합니다.
3. Progressive Web App (PWA) 섹션으로 이동합니다.
4. 필드를 작성합니다.
   • Name은 PWA의 표시 이름입니다.
   • Short name은 모바일 기기와 작은 화면에 표시됩니다.
5. 페이지 하단에서 Update appearance settings를 선택합니다.

Progressive Web App 설명을 추가하려면:

1. 오른쪽 상단 모서리에서 Admin을 선택합니다.
2. Settings > Appearance를 선택합니다.
3. Progressive Web App (PWA) 섹션으로 이동합니다.
4. 필드를 작성합니다. Markdown으로 Description을 형식화할 수 있습니다.
5. 페이지 하단에서 Update appearance settings를 선택합니다.

Progressive Web App 아이콘을 커스터마이즈하려면:

1. 오른쪽 상단 모서리에서 Admin을 선택합니다.
2. Settings > Appearance를 선택합니다.
3. Progressive Web App (PWA) 섹션으로 이동합니다.
4. Icon 아래에서 Choose file을 선택합니다.
5. 페이지 하단에서 Update appearance settings를 선택합니다.

멤버 가이드라인#

GitLab의 그룹 및 프로젝트 멤버 페이지에 멤버 가이드라인을 추가할 수 있습니다. 설명에 Markdown을 사용할 수 있습니다.

멤버 가이드라인은 다음 중 하나를 관리할 수 있는 권한이 있는 사용자에게 표시됩니다:

• 그룹의 멤버.
• 프로젝트의 멤버.

다음 방법 중 하나를 사용하여 그룹 및 프로젝트 멤버십을 관리하는 경우 멤버 가이드라인을 추가해야 합니다:

• 개별 단위가 아닌 미리 정의된 그룹으로.
• 외부 도구.

새 프로젝트 페이지에 가이드라인 추가#

New project page에 가이드라인 메시지를 추가합니다. Markdown으로 메시지를 형식화할 수 있습니다. 가이드라인 메시지는 New Project 메시지 아래 및 New project page 왼쪽에 표시됩니다.

New project page에 가이드라인 메시지를 추가하려면:

1. 오른쪽 상단 모서리에서 Admin을 선택합니다.
2. Settings > Appearance를 선택합니다.
3. New project pages 섹션으로 이동합니다.
4. 필드를 작성합니다. Markdown으로 가이드라인을 형식화할 수 있습니다.

프로필 이미지 가이드라인 추가#

프로필 이미지에 대한 가이드라인을 추가합니다.

1. 오른쪽 상단 모서리에서 Admin을 선택합니다.
2. Settings > Appearance를 선택합니다.
3. Profile image guideline 섹션으로 이동합니다.
4. 필드를 작성합니다. Markdown으로 텍스트를 형식화할 수 있습니다.

Libravatar#

GitLab은 아바타 이미지에 대해 Libravatar를 지원하지만 GitLab 인스턴스에서 Libravatar 지원을 수동으로 활성화해야 합니다. 자세한 내용은 서비스를 사용하기 위해 Libravatar를 참조하세요.

모든 새 사용자의 색상 테마 변경#

히스토리

• GitLab 17.8에서 도입: gitlab_default_theme은 1에서 10 사이의 값을 지정하여 기본 테마를 설정할 수 있습니다.
• 테마: Light Indigo, Light Blue, Light Green, Light Red가 GitLab 18.4에서 제거되었습니다.

모든 새 사용자의 기본 탐색 테마를 변경하려면:

1. /etc/gitlab/gitlab.rb에서 GitLab 구성 파일에 gitlab_rails['gitlab_default_theme']을 추가합니다:

   gitlab_rails['gitlab_default_theme'] = 2
   

   다음 색상을 사용할 수 있습니다:

   값	색상
   1	Indigo
   2	Dark
   3	Light
   4	Blue
   5	Green
   9	Red

2. GitLab 재구성 및 재시작.