\u00a0<\/p>\n<\/p>\n
GitBucket is an open-source Git platform similar to GitHub, written in Scala, that allows you to manage Git repositories on your own server. In this guide, we will walk you through how to install GitBucket with Nginx as a reverse proxy on Ubuntu 20.04 LTS. This setup works well whether you\u2019re using a or other VPS hosting environments.<\/p>\n
Before starting, ensure you have the following:<\/p>\n
Start by updating your system packages to ensure everything is up to date. Run the following command:<\/p>\n
sudo apt update && sudo apt upgrade<\/code><\/pre>\nStep 2: Install Java (OpenJDK)<\/h2>\n
GitBucket requires Java to run. Install OpenJDK 11 with the following command:<\/p>\n
sudo apt install openjdk-11-jdk -y<\/code><\/pre>\nAfter installation, verify that Java is installed by running:<\/p>\n
java -version<\/code><\/pre>\nYou should see the version output for OpenJDK 11.<\/p>\n
Step 3: Install GitBucket<\/h2>\n
Next, download the latest version of GitBucket from the official website. Navigate to your home directory and use wget<\/code> to download the GitBucket WAR file:<\/p>\ncd \/opt\r\nsudo wget https:\/\/github.com\/gitbucket\/gitbucket\/releases\/download\/4.37.1\/gitbucket.war<\/code><\/pre>\nCreate a dedicated directory for GitBucket and move the downloaded file:<\/p>\n
sudo mkdir \/opt\/gitbucket\r\nsudo mv gitbucket.war \/opt\/gitbucket<\/code><\/pre>\nStep 4: Create a Systemd Service for GitBucket<\/h2>\n
To ensure that GitBucket starts automatically when your server reboots, create a systemd service file:<\/p>\n
sudo nano \/etc\/systemd\/system\/gitbucket.service<\/code><\/pre>\nAdd the following content to the file:<\/p>\n
[Unit]\r\nDescription=GitBucket Service\r\nAfter=syslog.target\r\n\r\n[Service]\r\nExecStart=\/usr\/bin\/java -jar \/opt\/gitbucket\/gitbucket.war\r\nUser=root\r\nRestart=always\r\n\r\n[Install]\r\nWantedBy=multi-user.target<\/code><\/pre>\nSave and close the file, then reload the systemd manager and start GitBucket:<\/p>\n
sudo systemctl daemon-reload\r\nsudo systemctl start gitbucket\r\nsudo systemctl enable gitbucket<\/code><\/pre>\nStep 5: Install Nginx<\/h2>\n
GitBucket runs on port 8080 by default, but it’s a good practice to set up Nginx as a reverse proxy to serve GitBucket on port 80 (HTTP) or 443 (HTTPS). Install Nginx with the following command:<\/p>\n
sudo apt install nginx -y<\/code><\/pre>\nAfter installation, start and enable Nginx:<\/p>\n
sudo systemctl start nginx\r\nsudo systemctl enable nginx<\/code><\/pre>\nStep 6: Configure Nginx as a Reverse Proxy for GitBucket<\/h2>\n
Next, create a new Nginx configuration file for GitBucket:<\/p>\n
sudo nano \/etc\/nginx\/sites-available\/gitbucket<\/code><\/pre>\nAdd the following configuration, replacing your-domain.com<\/code> with your actual domain:<\/p>\nserver {\r\n listen 80;\r\n server_name your-domain.com;\r\n\r\n location \/ {\r\n proxy_pass http:\/\/localhost:8080;\r\n proxy_set_header Host $host;\r\n proxy_set_header X-Real-IP $remote_addr;\r\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\r\n proxy_set_header X-Forwarded-Proto $scheme;\r\n }\r\n}<\/code><\/pre>\nSave and close the file, then enable the site and restart Nginx:<\/p>\n
sudo ln -s \/etc\/nginx\/sites-available\/gitbucket \/etc\/nginx\/sites-enabled\/\r\nsudo systemctl restart nginx<\/code><\/pre>\nStep 7: Access GitBucket<\/h2>\n
Now, you can access GitBucket by visiting http:\/\/your-domain.com<\/code> or http:\/\/your-server-ip<\/code> in a web browser. The default login credentials are:<\/p>\n\n- Username:
root<\/code><\/li>\n- Password:
root<\/code><\/li>\n<\/ul>\nIt is highly recommended to change the root password after your first login.<\/p>\n
Step 8: (Optional) Enable SSL with Let’s Encrypt<\/h2>\n
To secure your GitBucket instance with SSL, you can use Let’s Encrypt. First, install Certbot:<\/p>\n
sudo apt install certbot python3-certbot-nginx -y<\/code><\/pre>\nThen, generate and install the SSL certificate by running the following command:<\/p>\n
sudo certbot --nginx -d your-domain.com<\/code><\/pre>\nFollow the prompts to complete the SSL installation. Certbot will automatically configure Nginx to redirect HTTP traffic to HTTPS.<\/p>\n
Conclusion<\/h2>\n
By following these steps, you have successfully installed GitBucket with Nginx as a reverse proxy on Ubuntu 20.04 LTS. Whether you’re hosting on a or other VPS solutions like Microsoft SQL VPS Windows<\/a>, GitBucket provides a flexible and powerful platform for managing Git repositories.<\/p>\n