diff --git a/README.md b/README.md index fa6188c..077f4db 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,48 @@ -# GitLab Community Edition docker image builder for arm64v8 +# GitLab-ce docker image builder for arm64v8 -Compatible with arm64v8 architectural. +Compatible with **arm64v8** architectural. Source building code: https://github.com/yrzr/gitlab-ce-arm64v8-docker -Docker Hub: https://hub.docker.com/r/yrzr/gitlab-ce-arm64v8 +Docker image: https://hub.docker.com/r/yrzr/gitlab-ce-arm64v8 Old builds on gitlab-ci: https://git.yrzr.tk/docker/gitlab-ce-arm64 + +## How to use + +The offical image (AMD64 only) is [here](https://hub.docker.com/r/gitlab/gitlab-ce/). + +The following is an example of how to use this image. + +```bash +docker run \ + --detach \ + --restart unless-stopped \ + --name gitlab-ce \ + --privileged \ + --memory 8G \ + --publish 22:22 \ + --publish 80:80 \ + --publish 443:443 \ + --publish 127.0.0.1:8181:8181 \ + --hostname gitlab.example.com \ + --env GITLAB_ROOT_PASSWORD="YourPasswordHere" \ + --env GITLAB_OMNIBUS_CONFIG=" \ + registry['enable'] = false; \ + GITLAB_OMNIBUS[your_other_configs] = here; "\ + --volume /srv/gitlab-ce/conf:/etc/gitlab:z \ + --volume /srv/gitlab-ce/logs:/var/log/gitlab:z \ + --volume /srv/gitlab-ce/data:/var/opt/gitlab:z \ + yrzr/gitlab-ce-arm64v8:latest +``` + +## Redis problem + +Redis cannot start with its default config on ARM64, which stops gitlab-ce from starting. You have to change the setting manually on a fresh install or an upgrade and then restart gitlab-ce. + +```bash +# change the path to your redis.conf +echo "ignore-warnings ARM64-COW-BUG" >> /srv/gitlab-ce/data/redis/redis.conf +# restart docker container +docker restart gitlab-ce +```