01‑gitlab‑setup

Remote GitLab CE provisioner (Docker‑Compose).

Disclaimer

Rapid Cloud‑Native setup. Not intended for high‑availability enterprise production.

Default internal credentials

• GitLab root password: gitlab
• Default ports: HTTP 80, HTTPS 443, Registry 5050, SSH 22

Prerequisites on target host

• Docker Engine + Docker Compose installed
• Root (or sudo) SSH access
• Minimum resources: 4 CPU cores, 4 GiB RAM, 25 GiB free disk space

Usage

cd modules/01-gitlab-setup
./execute.sh

The script will:

1. Prompt for target IP, SSH port, and authentication method.
2. Validate SSH connectivity.
3. Verify hardware specs and that no GitLab container is already running.
4. Detect port conflicts and allow custom ports.
5. Generate an enterprise‑grade docker-compose.yml and transfer it to /root/workspace/gitlab/ on the remote host.
6. Run docker compose up -d remotely.
7. On success, print the remote URL.

Monitoring & post‑install

• Live logs: ssh -p <SSH_PORT> root@<TARGET_IP> "docker logs -f gitlab"
• Initial root password: ssh -p <SSH_PORT> root@<TARGET_IP> "docker exec -it gitlab cat /etc/gitlab/initial_root_password"
• Customisation: edit the generated docker-compose.yml on the remote host (path /root/workspace/gitlab/) to change external_url, resource limits, or volume locations, then run docker compose up -d again.

Cleanup

If the script is interrupted (Ctrl+C) or any step fails, it automatically:

• Stops any partially started containers
• Removes /root/workspace/gitlab/ on the remote host
• Restores any altered host configuration

---

© Davoud Teimouri – StratoShell project