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) | |
spring.redis.timeout |
No | Maximum wait time for Redis operations. The value is specified in milliseconds or with a unit (e.g., 500ms, 2s). If the timeout is exceeded, the operation will fail with an error. Set this value based on your Redis server performance and application requirements. |
Redis Sentinel Configuration
Used for running GitFlic with a fault-tolerant Redis/KeyDB cluster managed by Sentinel. Requires at least two Sentinel nodes.
| Parameter | Required | Default Value | Description |
|---|---|---|---|
spring.redis.sentinel.master |
No | Name of the master instance as declared in the Sentinel configuration. Used to discover the current active master via Sentinel. | |
spring.redis.sentinel.nodes |
No | List of Sentinel node addresses in the format host:port, comma-separated. For proper Redisson operation, specify at least two nodes. |
|
spring.redis.sentinel.username |
No | Username for authenticating with Sentinel (used if ACL is configured in Redis/KeyDB). | |
spring.redis.sentinel.password |
No | Password for authenticating with Sentinel. If not set, Sentinel is assumed to be accessible without authentication. |
Redis / KeyDB Cluster Configuration
Used for running GitFlic with a sharded Redis or KeyDB cluster.
| Parameter | Required | Default Value | Description |
|---|---|---|---|
spring.redis.cluster.nodes |
No | List of cluster nodes in the format host:port, comma-separated. All cluster master nodes must be specified. |
|
spring.redis.cluster.max-redirects |
No | Maximum number of redirects (MOVED/ASK) for a single operation. For high request volumes, you may need to increase this value. |
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 |
Disables system analysis in the administrator panel. Available in version 3.0.0 and above. |
gitflic.base.url |
Yes | http://localhost:8080 |
Responsible for generating links for external sources, such as links in emails. If no data transfer protocol is specified, https:// will be used by default. |
gitflic.transport.url |
Yes | http://localhost:8080 |
Responsible for generating the link that is displayed on each project page and returned in data from API methods and webhook data. |
gitflic.coordinator.url |
No | Same as gitflic.base.url |
Overrides the protocol, domain, and port used to generate registration links for CI/CD runners. Used if a separate coordinator is deployed. |
gitflic.defaultPackSize |
No | 100MB |
Limits the maximum pack size that Git can send during a push to a repository. The following suffixes are allowed: KB, MB, GB, TB. |
gitflic.limitPackSize |
No | false |
Used to enable or disable the limit on the pack size sent when performing a push to a project. |
gitflic.limitProjectSize |
No | false |
Used to enable or disable the mechanism for limiting the maximum repository size. |
logging.file.name |
No | /var/log/gitflic/server.log |
The directory (including the file name) where the log file is stored. |
logging.level.root |
No | INFO |
Logging level.* |
gitflic.ci-cd.config-processing.max-job-variable-count |
No | 1000 |
The maximum number of variables for a job, including predefined ones. |
gitflic.ci-cd.config-processing.job-variables-size-limit-characters |
No | 262144 |
The limit on the total number of characters in variables (key + value), including predefined ones. |
gitflic.ci-cd.runners.global-properties.enabled |
No | false |
Allows changing runner parameters: true or false (for the following properties). |
gitflic.ci-cd.runners.global-properties.log-limit-kilobytes |
No | 100 |
The maximum log size for all runners in kilobytes. Possible values range from 10 to 25600 KB. The setting is active only when gitflic.ci-cd.runners.global-properties.enabled is set to true. |
gitflic.ci-cd.runners.global-properties.job-variables-size-limit-characters |
No | No | The limit on the total number of characters in variables (key + value) for all runners. The setting is active only when gitflic.ci-cd.runners.global-properties.enabled is set to true. |
gitflic.ci-cd.runners.global-properties.countOfJobsToProcess |
No | No | The limit on the maximum number of parallel threads when executing jobs. The setting is active only when gitflic.ci-cd.runners.global-properties.enabled is set to true. |
togglz.features.GITFLIC_NEWSFLIC.enabled |
No | true in On-premise, false in Enterprise |
When true, the GitFlic News section becomes available in the Enterprise build. It is impossible to disable this functionality in the On-premise build. |
gitflic.atlas.trash_can.lifetime |
No | 7 |
The number of days that registry repository files remain in the trash before being permanently deleted. |
gitflic.ci-cd.include.max-recursion-depth |
No | 3 |
The maximum number of files that can be included into each other using the include keyword (through a chain of nesting). Can take values from 0 to 150. |
gitflic.atlas.cleanup-policy.latency-hours |
No | 6 |
The maximum possible time between the scheduled and actual run of the cleanup policy (in hours). |
gitflic.atlas.cleanup-policy.deleted-package-limit |
No | 100000 |
The maximum number of packages deleted during a single run of the cleanup policy. |
gitflic.ci-cd.downstream-pipeline.max-recursion-depth |
No | 3 |
The maximum allowed depth for creating child pipelines using the trigger keyword. |
gitflic.ci-cd.config-processing.max-job-variable-count |
No | 1000 | The maximum number of variables for a job. |
gitflic.ci-cd.config-processing.job-variables-size-limit-characters |
No | No | The limit on the coordinator for the maximum number of characters in variables (the character count of all keys + the character count of all values). |
*Logging level table
| 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 | Enables Elasticsearch in the build. |
search.provider |
No | elastic | A switch for selecting the search system. Specify opensearch when connecting OpenSearch version 2 or 3. |
elasticsearch.rest.uri |
No | localhost:9200 | The connection address for Elasticsearch. |
elasticsearch.useSsl |
No | false | Use an SSL certificate for the protocol. |
elasticsearch.username |
No | The username for authenticating in Elasticsearch. | |
elasticsearch.password |
No | The password for authenticating in Elasticsearch. | |
elasticsearch.connection-timeout |
No | 1 | Sets the connection timeout. |
elasticsearch.read-timeout |
No | 30 | Sets the read timeout. |
gitflic.schedule.elastic-index |
No | false | Enables automatic indexing of entities – projects, users, companies, packages. The indexing period is specified using the parameter gitflic.elastic.indexation.period. |
gitflic.schedule.elastic-index.code |
No | false | Enables automatic indexing of code. The indexing period is specified using the parameter gitflic.elastic.indexation.period. |
gitflic.elastic.indexation.period |
No | 168 | The entity indexing period. Specified in hours. |
elasticsearch.index.highlight.max_analyzed_offset |
No | 1000000 | The maximum number of characters in a code file that can be included in the index. |
Full info by link
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.
LDAP synchronization configuration
| Parameter | Required | Default value | Description |
|---|---|---|---|
gitflic.kubernetes-agent.server.url |
No | The URL for the GitFlic Kubernetes proxy. | |
gitflic.kubernetes-agent.server.grpc.port |
No | The GRPC port of the GitFlic Kubernetes proxy. |
Additional information on the GitFlic Kubernetes proxy can be found in the documentation.
LDAP synchronization configuration
| Parameter | Required | Default value | Description |
|---|---|---|---|
gitflic.ldap.scheduler.user.update.rate.minutes |
No | 60 | The parameter is responsible for the frequency of updating user data, including first name, last name, and email address. The value is specified in minutes. |
gitflic.ldap.scheduler.member.update.rate.minutes |
No | 1440 | The parameter is responsible for the frequency of updating user membership, including distribution across teams and companies. The value is specified in minutes. |
Automatic translation!
This page has been automatically translated. The text may contain inaccuracies.