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. |
gitflic.ci-cd.include.max-recursion-depth |
No | 3 |
The maximum number of files that can be included using the include keyword (via a nesting chain). Can range from 0 to 150 |
gitflic.atlas.cleanup-policy.latency-hours |
No | 6 |
The maximum possible time between the scheduled and actual launch of cleanup policy (in hours) |
gitflic.atlas.cleanup-policy.deleted-package-limit |
No | 100,000 |
Maximum number of packages deleted during a single run of cleanup policy |
*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.