GitLab Docker Interactive Installer
This repository contains an automated installation script for GitLab CE running inside a Proxmox LXC container with Docker.
Features
- Interactive prompts for essential configuration (admin email, SMTP, root password, LXC IP).
- Automates Docker installation, container launch, and GitLab setup.
- Automatically configures SMTP email for notifications.
- Sets the initial root password as provided by the user.
- Displays admin password and access instructions upon completion.
Prerequisites
- A Proxmox LXC container with a working Linux OS (Debian/Ubuntu recommended).
- Network access to the container with a known IP.
- Access to run commands with
sudoinside the container. - An SMTP email account for sending GitLab notification emails.
Installation Instructions
- Download and run the installer script inside your LXC container
curl -sSL https://your-server/path/install_gitlab.sh | sudo bash
- Enter the requested information:
- LXC container IP (used for informational purposes).
- Admin email address (for system notifications).
- SMTP email address and password.
- SMTP server address and port (e.g. smtp.gmail.com and 465).
- Initial root password for GitLab (must meet complexity requirements).
- Wait for the script to complete
The script will install Docker and dependencies, pull the GitLab container, and start it with your settings.
Post-install Access
- Once initialized, access GitLab via the LXC container IP:
http://<LXC_CONTAINER_IP>
- Log in with username:
root
-
And the initial root password you provided during installation.
-
It is strongly recommended to change the root password immediately after first login.
Troubleshooting
- Monitor container logs:
sudo docker logs -f gitlab
- If login fails, use the GitLab rails runner to reset the root password:
sudo docker exec -it gitlab gitlab-rails runner "user = User.where(id: 1).first; user.password = 'NEWPASSWORD'; user.password_confirmation = 'NEWPASSWORD'; user.save!"
License
This installation script and README are provided as-is without warranty. Use at your own risk.
Support
For further GitLab usage and administration, refer to the official GitLab documentation: