tjh.dev
forked from
tangled.org/core
Mirror of @tangled.org/core. Running on a Raspberry Pi Zero 2
docs: add a small troubleshooting section to knots
Signed-off-by: oppiliappan <me@oppi.li>
oppi.li
+83
docs/DOCS.md
+83
docs/DOCS.md
···
502
502
Note that you should add a newline at the end if setting a non-empty message
503
503
since the knot won't do this for you.
504
504
505
+
## Troubleshooting
506
+
507
+
If you run your own knot, you may run into some of these
508
+
common issues. You can always join the
509
+
[IRC](https://web.libera.chat/#tangled) or
510
+
[Discord](https://chat.tangled.org/) if this section does
511
+
not help.
512
+
513
+
### Unable to push
514
+
515
+
If you are unable to push to your knot or repository:
516
+
517
+
1. First, ensure that you have added your SSH public key to
518
+
your account
519
+
2. Check to see that your knot has synced the key by running
520
+
`knot keys`
521
+
3. Check to see if git is supplying the correct private key
522
+
when pushing: `GIT_SSH_COMMAND="ssh -v" git push ...`
523
+
4. Check to see if `sshd` on the knot is rejecting the push
524
+
for some reason: `journalctl -xeu ssh` (or `sshd`,
525
+
depending on your machine). These logs are unavailable if
526
+
using docker.
527
+
5. Check to see if the knot itself is rejecting the push,
528
+
depending on your setup, the logs might be in one of the
529
+
following paths:
530
+
* `/tmp/knotguard.log`
531
+
* `/home/git/log`
532
+
* `/home/git/guard.log`
533
+
505
534
# Spindles
506
535
507
536
## Pipelines
···
1590
1561
Refer to the [jujutsu
1591
1562
documentation](https://jj-vcs.github.io/jj/latest/config/#commit-trailers)
1592
1563
for more information.
1564
+
1565
+
# Troubleshooting guide
1566
+
1567
+
## Login issues
1568
+
1569
+
Owing to the distributed nature of OAuth on AT Protocol, you
1570
+
may run into issues with logging in. If you run a
1571
+
self-hosted PDS:
1572
+
1573
+
- You may need to ensure that your PDS is timesynced using
1574
+
NTP:
1575
+
* Enable the `ntpd` service
1576
+
* Run `ntpd -qg` to synchronize your clock
1577
+
- You may need to increase the default request timeout:
1578
+
`NODE_OPTIONS="--network-family-autoselection-attempt-timeout=500"`
1579
+
1580
+
## Empty punchcard
1581
+
1582
+
For Tangled to register commits that you make across the
1583
+
network, you need to setup one of following:
1584
+
1585
+
- The committer email should be a verified email associated
1586
+
to your account. You can add and verify emails on the
1587
+
settings page.
1588
+
- Or, the committer email should be set to your account's
1589
+
DID: `git config user.email "did:plc:foobar". You can find
1590
+
your account's DID on the settings page
1591
+
1592
+
## Commit is not marked as verified
1593
+
1594
+
Presently, Tangled only supports SSH commit signatures.
1595
+
1596
+
To sign commits using an SSH key with git:
1597
+
1598
+
```
1599
+
git config --global gpg.format ssh
1600
+
git config --global user.signingkey ~/.ssh/tangled-key
1601
+
```
1602
+
1603
+
To sign commits using an SSH key with jj, add this to your
1604
+
config:
1605
+
1606
+
```
1607
+
[signing]
1608
+
behavior = "own"
1609
+
backend = "ssh"
1610
+
key = "~/.ssh/tangled-key"
1611
+
```
1612
+
1613
+
## Self-hosted knot issues
1614
+
1615
+
If you need help troubleshooting a self-hosted knot, check
1616
+
out the [knot troubleshooting
1617
+
guide](/knot-self-hosting-guide.html#troubleshooting).