๐Ÿ›Debugging

If you are having technical issues with the GitButler client, here are a few things you can do to help us help you. Or help yourself.

If you get stuck or need help with anything, hit us up over on Discord, here's GitButler Discord Server Link

Logs

Often the most helpful thing is to look at the logs. GitButler is a Tauri app, so the logs are in your OS's app log directory. This should be:

  • Linux: ~/.config/com.gitbutler.app/logs/

  • macOS: ~/Library/Logs/com.gitbutler.app/

  • Windows: C:\Users\[username]\AppData\Roaming\com.domain.appname\logs

In this directory, there should be rolling daily logs:

โฏ cd ~/Library/Logs/com.gitbutler.app

โฏ tree -L 1
.
โ”œโ”€โ”€ GitButler.log
โ”œโ”€โ”€ GitButler.log.2023-09-02
โ”œโ”€โ”€ GitButler.log.2023-09-03
โ”œโ”€โ”€ GitButler.log.2023-09-04
โ”œโ”€โ”€ GitButler.log.2023-09-05
โ”œโ”€โ”€ GitButler.log.2023-09-06
โ”œโ”€โ”€ GitButler.log.2023-09-07
โ”œโ”€โ”€ GitButler.log.2023-09-08
โ”œโ”€โ”€ GitButler.log.2023-10-10
โ”œโ”€โ”€ GitButler.log.2024-01-30
โ””โ”€โ”€ tokio-console

โฏ tail GitButler.log.2024-01-30 
2024-01-30T13:02:56.319843Z  INFO get_public_key: gitbutler-app/src/keys/commands.rs:20: new
2024-01-30T13:02:56.320000Z  INFO git_get_global_config: gitbutler-app/src/commands.rs:116: new key="gitbutler.utmostDiscretion"
2024-01-30T13:02:56.320117Z  INFO git_get_global_config: gitbutler-app/src/commands.rs:116: new key="gitbutler.signCommits"
2024-01-30T13:02:56.320194Z  INFO get_public_key: gitbutler-app/src/keys/commands.rs:20: close time.busy=317ยตs time.idle=47.0ยตs
2024-01-30T13:02:56.320224Z  INFO git_get_global_config: gitbutler-app/src/commands.rs:116: close time.busy=204ยตs time.idle=25.3ยตs key="gitbutler.utmostDiscretion"
2024-01-30T13:02:56.320276Z  INFO git_get_global_config: gitbutler-app/src/commands.rs:116: close time.busy=133ยตs time.idle=35.8ยตs key="gitbutler.signCommits"
2024-01-30T13:02:56.343467Z  INFO menu_item_set_enabled: gitbutler-app/src/menu.rs:11: new menu_item_id="project/settings" enabled=false
2024-01-30T13:02:56.343524Z  INFO menu_item_set_enabled: gitbutler-app/src/menu.rs:11: close time.busy=35.7ยตs time.idle=28.8ยตs menu_item_id="project/settings" enabled=false

Data Files

GitButler also keeps it's own data about each of your projects. The virtual branch metadata, your user config stuff, a log of changes in each file, etc. If you want to inspect what GitButler is doing or debug or reset everything, you can go to our data directory.

  • Linux: ~/.local/share/com.gitbutler.app/

  • macOS: ~/Library/Application Support/com.gitbutler.app/

  • Windows: C:\Users\[username]\AppData\Roaming\com.domain.appname

In this folder there are a bunch of interesting things.

โฏ cd ~/Library/Application\ Support/com.gitbutler.app

โฏ tree .
.
โ”œโ”€โ”€ keys
โ”‚ย ย  โ”œโ”€โ”€ ed25519
โ”‚ย ย  โ””โ”€โ”€ ed25519.pub
โ”œโ”€โ”€ projects.json
โ””โ”€โ”€ settings.json

4 directories, 4 files

The projects.json file will have a list of your projects metadata:

โฏ cat projects.json 
[
  {
    "id": "71218b1b-ee2e-4e0f-8393-54f467cd665b",
    "title": "gitbutler-blog",
    "description": null,
    "path": "/Users/scottchacon/projects/gitbutler-blog",
    "preferred_key": "generated",
    "ok_with_force_push": true,
    "api": null,
    "gitbutler_data_last_fetch": null,
    "gitbutler_code_push_state": null,
    "project_data_last_fetch": {
      "fetched": {
        "timestamp": {
          "secs_since_epoch": 1706619724,
          "nanos_since_epoch": 202467000
        }
      }
    }
  }
]

The settings.json are some top level preferences you've set. A lot of stu

โฏ cat settings.json
{"appAnalyticsConfirmed":true,"appNonAnonMetricsEnabled":true}%

Finally, the keys directory holds the SSH key that we generate for you in case you don't want to go through creating your own. It's only used if you want to use it to sign commits or use it for authentication.

Last updated