LinkGraph¶
LinkGraph shows who you know where, from your own LinkedIn data export. The cluster copy is for
lookups on the phone at events: a person, a company, and your notes on them. The separate
mortennordbye/linkgraph repo builds its image, ghcr.io/mortennordbye/linkgraph. The
manifests live in
k8s/talos/apps/linkgraph/.
| URL | https://linkgraph.local.bigd.no |
| Namespace | linkgraph |
| Delivery | Kargo project linkgraph-cd, straight to prod through a promotion PR (../../platform/delivery/kargo.md) |
| Backup | VolSync, nightly at 01:45 (../../platform/backups/README.md) |
Get the export into the app¶
- Request the export from LinkedIn. The steps are in the linkgraph README, Get your LinkedIn data. Tick at least Connections and Messages. LinkedIn emails you after about 10 minutes.
- Download the zip. On an iPhone, open the LinkedIn link in Safari, not in the LinkedIn app. The zip goes to Files > Downloads.
- Open
https://linkgraph.local.bigd.no, press Import zip in the header and pick the file. The app saves it to the volume and loads it. Older exports stay in the Export menu.
To install it as an app, choose Share > Add to Home Screen in Safari.
Pod¶
One replica with Recreate, because the data PVC is ReadWriteOnce
(deployment.yaml). It runs as uid 1000,
fsGroup: 1000, with all capabilities dropped. LINKGRAPH_ALLOWED_HOSTS adds the hostname to
the app's Host-header allowlist; without it every request gets a 400.
Storage¶
| Mount | Source | Holds |
|---|---|---|
/data |
PVC linkgraph-data-pvc, 5Gi, syno-nfs-csi |
exports/ (imported zips), linkgraph-notes.json (statuses, notes, merges), logo-cache/ |
VolSync backs it up with restic to /volume1/k8s-backups/volsync on the NAS
(volsync.yaml).
Exposure¶
The HTTPRoute attaches to traefik-gateway-private only. The app is reachable from the LAN and
over Tailscale, not from the internet. The app has no login and nothing in this repo puts one in
front of it, so every device on the LAN and the tailnet can read the contacts and messages.
Never give it a route on the public gateway. The internal DNS alias is in
terraform/unifi/dns/records.tf.
The CiliumNetworkPolicy allows ingress on 8765 from Traefik and the host. Egress is DNS and
https to public addresses only, for Fetch logos
(ciliumnetworkpolicy.yaml).