application.properties Configuration
This section contains information about the application.properties file parameters.
Server Configuration
| Parameter |
Required |
Default Value |
Description |
server.port |
Yes |
8080 |
Port for GitFlic application |
server.address |
Yes |
localhost |
IP address for GitFlic application |
ssh.server.port |
Yes |
22 |
SSH server port for remote-url access |
ssh.server.host |
No |
localhost |
SSH server host for remote-url access |
spring.servlet.multipart.maxFileSize |
No |
500MB |
Maximum file size for forms and API requests |
spring.servlet.multipart.maxRequestSize |
No |
500MB |
Maximum request size |
gitflic.async-task-executor.default-timeout |
No |
30 |
Timeout for file downloads via web interface (default in minutes, can use other units like 30s for seconds) |
Database Configuration
| Parameter |
Required |
Default Value |
Description |
spring.datasource.url |
Yes |
jdbc:postgresql://localhost/gitflic |
PostgreSQL connection URL |
spring.datasource.username |
Yes |
gitflic |
PostgreSQL username |
spring.datasource.password |
Yes |
gitflic |
PostgreSQL password |
spring.redis.host |
Yes |
localhost |
Redis host |
spring.redis.port |
Yes |
6379 |
Redis port |
spring.redis.username |
No |
|
Redis username |
spring.redis.password |
No |
|
Redis password |
spring.redis.database |
No |
0 |
Redis database number |
spring.redis.ssl |
No |
false |
Use HTTPS for Redis connection |
spring.redis.url |
No |
|
Full Redis connection URL (overrides host/port/password parameters) |
Application Directory Settings
Directory paths must end with /
| Parameter |
Required |
Default Value |
Description |
ssh.server.cert |
Yes |
/opt/gitflic/cert/key.pem |
Path to SSH transport certificate |
repository.dir |
Yes |
/var/gitflic/repo/ |
Directory for git repositories |
image.upload.dir |
Yes |
/var/gitflic/img/ |
Directory for avatars and media files |
releases.upload.dir |
Yes |
/var/gitflic/releases/ |
Directory for git tag release files |
cicd.pipeline.dir |
Yes |
/var/gitflic/cicd/ |
CI/CD agent directory |
gitflic.registry.package.dir |
Yes |
/var/gitflic/registry/ |
Package registry files directory |
audit.event-log.dir |
No |
{gitflic.jar_path}/audit |
Audit log directory |
gitflic.vault.cert.publicKey |
No |
Same as ssh.server.cert |
PKCS #8 public key path (auto-generated if write permissions exist) |
gitflic.vault.cert.privateKey |
No |
Same as ssh.server.cert |
PKCS #8 private key path (auto-generated if write permissions exist) |
SMTP Server Configuration
| Parameter |
Required |
Default Value |
Description |
spring.mail.host |
Yes |
smtp.foo.bar |
SMTP server address |
spring.mail.port |
Yes |
587 |
SMTP server port |
spring.mail.username |
Yes |
foo@bar.net |
SMTP authentication username |
spring.mail.password |
Yes |
Superp@\$$word |
SMTP authentication password |
smtp.sender.name |
No |
foobar |
Email sender name |
smtp.sender.email |
No |
foo@noreply.bar |
Email sender address |
spring.mail.properties.mail.smtp.starttls.enable |
No |
false |
Enable TLS |
spring.mail.properties.mail.smtp.ssl.enable |
No |
false |
Enable SSL |
spring.mail.properties.mail.smtp.auth |
No |
false |
Enable authentication |
Application General Properties
| Parameter |
Required |
Default Value |
Description |
gitflic.system.dashboard.enabled |
No |
true |
Disable system analysis in admin panel (v3.0.0+) |
gitflic.base.url |
Yes |
http://localhost:8080 |
Base URL for external links (defaults to HTTPS if no protocol specified) |
gitflic.transport.url |
Yes |
http://localhost:8080 |
URL displayed in project pages and API/webhook data |
gitflic.coordinator.url |
No |
Same as base URL |
Overrides protocol/domain/port for CI/CD agent registration links |
gitflic.defaultPackSize |
No |
100MB |
Maximum git push package size (supports KB, MB, GB, TB suffixes) |
gitflic.limitPackSize |
No |
false |
Enable/disable push package size limit |
gitflic.limitProjectSize |
No |
false |
Enable/disable repository size limit |
logging.file.name |
No |
/var/log/gitflic/server.log |
Log file path |
logging.level.root |
No |
INFO |
Logging level* |
gitflic.ci-cd.config-processing.max-job-variable-count |
No |
1000 |
Maximum job variables (including predefined) |
gitflic.ci-cd.config-processing.job-variables-size-limit-characters |
No |
262144 |
Total variable characters limit (key + value, including predefined) |
gitflic.ci-cd.runners.global-properties.enabled |
No |
false |
Enable agent parameter modification |
gitflic.ci-cd.runners.global-properties.log-limit-kilobytes |
No |
100 |
Maximum log size for all agents (10-25600 KB, requires enabled=true) |
gitflic.ci-cd.runners.global-properties.job-variables-size-limit-characters |
No |
None |
Total variable characters limit for all agents (requires enabled=true) |
gitflic.ci-cd.runners.global-properties.countOfJobsToProcess |
No |
None |
Limits the maximum number of parallel job execution threads. This setting is only active when parameter gitflic.ci-cd.runners.global-properties.enabled is set to true |
togglz.features.GITFLIC_NEWSFLIC.enabled |
No |
true in Onpremise, false in Enterprise |
Enable GitFlic News section (cannot be disabled in Onpremise) |
gitflic.atlas.trash_can.lifetime |
No |
7 |
The number of days that registry repository files remain in the trash before being permanently deleted. |
*Logging Levels
| Parameter |
Description |
OFF |
No logging |
ERROR |
Critical errors preventing normal operation |
WARN |
Warnings |
INFO |
Informational messages for users and administrators |
DEBUG |
Detailed tracing for developers |
ALL |
All messages |
RabbitMQ Configuration
Enterprise and Atlas edition only
| Parameter |
Required |
Default Value |
Description |
spring.rabbitmq.host |
No |
localhost |
RabbitMQ server address |
spring.rabbitmq.port |
No |
5672 |
RabbitMQ server port |
spring.rabbitmq.username |
No |
|
RabbitMQ authentication username |
spring.rabbitmq.password |
No |
|
RabbitMQ authentication password |
*Additional RabbitMQ settings: Spring Boot Documentation
Apache Kafka Configuration
Enterprise and Atlas edition only
| Parameter |
Required |
Default Value |
Description |
gitflic.kafka |
No |
false |
If set to true, Apache Kafka will be used as the message broker. |
spring.kafka.bootstrap-servers |
No |
localhost:9092 |
Comma-delimited list of host:port pairs to use for establishing the initial connections to Kafka |
Elasticsearch Configuration
| Parameter |
Required |
Default Value |
Description |
gitflic.elasticsearch.enabled |
No |
false |
Enable Elasticsearch |
elasticsearch.rest |
No |
localhost:9200 |
Elasticsearch connection address |
elasticsearch.useSsl |
No |
false |
Use SSL certificate |
elasticsearch.username |
No |
|
Elasticsearch authentication username |
elasticsearch.password |
No |
|
Elasticsearch authentication password |
elasticsearch.connection-timeout |
No |
1 |
Connection timeout (seconds) |
elasticsearch.read-timeout |
No |
30 |
Read timeout (seconds) |
gitflic.schedule.elastic-index |
No |
false |
Enable automatic indexing (projects/users/companies/packages) |
gitflic.schedule.elastic-index.code |
No |
false |
Enable code indexing |
gitflic.elastic.indexation.period |
No |
168 |
Indexing period (hours) |
elasticsearch.index.highlight.max_analyzed_offset |
No |
1000000 |
Maximum characters in code files for indexing |
Telegram Integration
| Parameter |
Required |
Default Value |
Description |
telegram.webhook.host |
No |
|
Telegram webhook URL for bot registration |
telegram.bot.token |
No |
|
Telegram bot access token |
secret.telegram.token |
No |
|
Secure access token for your Telegram bot |
GitFlic Kubernetes Proxy
| Parameter |
Required |
Default Value |
Description |
gitflic.kubernetes-agent.server.url |
No |
|
GitFlic Kubernetes proxy URL |
gitflic.kubernetes-agent.server.grpc.port |
No |
|
GitFlic Kubernetes proxy GRPC port |
For more information about GitFlic Kubernetes proxy, see the documentation.
Automatic translation!
This page has been automatically translated. The text may contain inaccuracies.