Updated with clearer instructions for configuring Apache

Shaun Henderson
2024-11-22 19:50:18 +13:00
parent f82b00dfb7
commit 6ea3d71a26

@@ -1,16 +1,28 @@
### Prerequisites ### Prerequisites
1. Apache is installed and running on your server. 1. Apache is installed and running on your server.
2. GitBucket is running on some `port`. The default is `8080`. 2. GitBucket is running on some `port`. The default is `8080`.
3. You are using the prefix of `/gitbucket`.
### Apache HTTP server set up ### Apache HTTP server set up
1. Install and enable `mod_proxy` and `mod_proxy_http` modules. 1. Install and enable `mod_proxy` and `mod_proxy_http` modules:
2. Add the following to your site configuration (assuming your GitBucket prefix is "gitbucket") [where i can find site configuration?]: ```
sudo a2enmod proxy
sudo a2enmod proxy_http
```
2. Add the following to your site configuration (`sudo nano /etc/apache2/sites-enabled/000-default.conf`) AFTER the default VirtualHost:
```
<VirtualHost *:80>
...
</VirtualHost>
AllowEncodedSlashes NoDecode # ... or "On" for Apache-2.2 AllowEncodedSlashes NoDecode # ... or "On" for Apache-2.2
ProxyPreserveHost On ProxyPreserveHost On
ProxyPass /gitbucket http://localhost:8080/gitbucket ProxyPass /gitbucket http://localhost:8080/gitbucket
ProxyPassReverse /gitbucket http://localhost:8080/gitbucket ProxyPassReverse /gitbucket http://localhost:8080/gitbucket
3. Go to System Settings (http://localhost/gitbucket/admin/system) and modify the Base URL to https://www.example.com/gitbucket ```
You can also use %{SERVER_NAME} in place of localhost.
3. Restart Apache:
`sudo apache2 restart`
4. Go to System Settings (http://localhost:8080/gitbucket/admin/system) and modify the Base URL to https://www.example.com/gitbucket
> Note! Apache and GitBucket context paths must be equal: > Note! Apache and GitBucket context paths must be equal:
`java -jar gitbucket.war --port=8080 --prefix=/gitbucket` `java -jar gitbucket.war --port=8080 --prefix=/gitbucket`