Skip to content

Configuring and Launching the GitFlic Application

Before configuring the application, familiarize yourself with the purpose of the parameters on the application.properties Configuration page.

Configuration

  • Application configuration is performed by modifying the corresponding parameters in the application.properties file, which was copied earlier during installation.
  • All parameters marked as mandatory must be defined in the file.
  • To apply changes, the application must be restarted.

Launching the GitFlic Application

Execute the launch command:12

The command is executed from the folder where the application was installed, /opt/gitflic/bin by default. 

sudo -u gitflic java -jar gitflic.jar --spring.config.additional-location=/etc/gitflic/application.properties

  1. Create a systemd unit file: 

    touch /etc/systemd/system/gitflic-server.service

  2. Insert the necessary launch parameters into /etc/systemd/system/gitflic-server.service: 

    sudo cat <<EOF >> /etc/systemd/system/gitflic-server.service  
Description=Startup unit for run Gitflic service  
Documentation=https://docs.gitflic.space/  
After=network.target  

[Service]  
Type=simple  
User=gitflic  
Group=gitflic  

WorkingDirectory=/opt/gitflic/  
ExecStart=/usr/bin/java -jar /opt/gitflic/bin/gitflic.jar --spring.config.additional-location=file:/etc/gitflic/  
ExecStop=/bin/kill -s 15 $MAINPID  
Restart=on-failure  
RestartSec=30  

[Install]  
WantedBy=multi-user.target  
EOF
    /etc/systemd/system/gitflic-server.service 
    Description=Startup unit for run Gitflic service  
Documentation=https://docs.gitflic.space/  
After=network.target  

[Service]  
Type=simple  
User=gitflic  
Group=gitflic  

WorkingDirectory=/opt/gitflic/  
ExecStart=/usr/bin/java -jar /opt/gitflic/bin/gitflic.jar --spring.config.additional-location=file:/etc/gitflic/  
ExecStop=/bin/kill -s 15 $MAINPID  
Restart=on-failure  
RestartSec=30  

[Install]  
WantedBy=multi-user.target

  3. Reload the systemd units: 

    sudo systemctl daemon-reload

  4. Enable autostart and launch the service: 

    systemctl enable gitflic-server.service  
systemctl start gitflic-server.service
  • After launching, navigate to the address specified during configuration and verify the service's functionality.

Default User Credentials

  • Email - adminuser@admin.local
  • Password - qwerty123

Automatic Translation!

This page has been translated using automated tools. The text may contain inaccuracies.

  1. The --spring.config.additional-location= parameter specifies the application configuration file. ↩

  2. For details about JVM and application launch parameters, refer to this page. ↩