| 1 | # Ferrenium configuration. Every key is optional; the values shown are the |
| 2 | # defaults unless noted. Unknown keys are an error: run `ferrenium check`. |
| 3 | # Relative paths are resolved against the directory of this file. |
| 4 | # Apply changes with `systemctl reload ferrenium`. |
| 5 | |
| 6 | [server] |
| 7 | listen = "127.0.0.1:8080" # or "unix:/run/ferrenium/ferrenium.sock" |
| 8 | # base_url = "https://git.example.com" # for absolute URLs (feeds); default: http://{Host header} |
| 9 | base_path = "/" # serve under a sub-path, e.g. "/git/" |
| 10 | trusted_proxy = true # log X-Forwarded-For; default: false |
| 11 | compression = true # gzip |
| 12 | |
| 13 | [site] |
| 14 | title = "ferrenium" |
| 15 | # description = "Personal git repositories" |
| 16 | # clone_urls = ["https://git.example.com/{name}", "git@git.example.com:{name}"] |
| 17 | # custom_css = "custom.css" |
| 18 | # header = "header.html" |
| 19 | # footer = "footer.html" |
| 20 | |
| 21 | [repos] |
| 22 | scan_path = "/home/git" |
| 23 | max_depth = 3 |
| 24 | follow_symlinks = false |
| 25 | section_from_path = false |
| 26 | hide = [] # globs over repo names, e.g. ["private/*"] |
| 27 | snapshots = ["tar.gz", "zip"] |
| 28 | https_clone = true |
| 29 | |
| 30 | # Optional per-repo overrides (take precedence over git config and the |
| 31 | # repository's description file). |
| 32 | # [[repo]] |
| 33 | # name = "dotfiles" |
| 34 | # description = "My dotfiles" |
| 35 | # section = "config" |
| 36 | # owner = "me" |
| 37 | # hidden = false |
| 38 | # readme = "docs/README.md" |
| 39 | # default_branch = "main" |
| 40 | |
| 41 | [ui] |
| 42 | theme = "auto" # auto | dark | light |
| 43 | index_sort = "activity" # repository index order: activity | name |
| 44 | code_font = "Space Mono" |
| 45 | max_blob_kb = 1024 |
| 46 | max_highlight_kb = 256 |
| 47 | log_page = 50 # commits per log page |
| 48 | |
| 49 | [cache] |
| 50 | size_mb = 64 |
| 51 | |
| 52 | [watch] |
| 53 | enabled = true |
| 54 | debounce_ms = 500 |
| 55 | poll_interval_secs = 300 # 0 disables the periodic full rescan |
| 56 | |
| 57 | [limits] |
| 58 | git_parallel = 0 # 0 = CPUs, at most 8 |
| 59 | heavy_parallel = 2 # blame, archives, clones and log searches at once |
| 60 | heavy_wait_secs = 10 # queue time for a heavy permit before a 503 |
| 61 | max_requests = 512 # requests in flight; more get an immediate 503 |
| 62 | request_timeout_secs = 30 # until the response starts; streamed bodies are not cut |
| 63 | log_scan = 10000 # commits examined per page by path/grep log filters |
| 64 | diff_files = 300 # larger commits show the file list only |
| 65 | diff_lines = 10000 # changed lines rendered per commit |
| 66 | diff_file_lines = 2000 # changed lines rendered per file |
| 67 | |
| 68 | [log] |
| 69 | level = "info" # RUST_LOG takes precedence when set |