Local Git remotes

ssurprisetalk 1 day ago 73 commentsRead Article on cblgh.org

FR version is available. Content is displayed in original English for accuracy.

⚡ Community Insights

Discussion Sentiment

83% Positive

Analyzed from 2067 words in the discussion.

Discussion (73 Comments)Read Original on HackerNews

zenoprax•1 day ago

I was expecting the use of non-SSH git remotes without network access. Any mounted file system can be a valid remote such as a USB drive. I use file-based remote to keep some repos encrypted on S3 using Rclone.

For example, `git remote -v` would show: `secure-s3 /mnt/fuse/rclone/secure-s3/git/$REPO.git`

I think concurrency is a problem with file-based remotes but for one person keeping a desktop and laptop in sync it is much simpler than running a VPS.

kmarc•1 day ago

I use Keybase's encrypted git repo the same way (to sync "private" dotfiles across laptops / remote workstations)

theptip•1 day ago

How is Keybase doing these days? I stopped following after the acquisition, but I like the concept.

kmarc•about 18 hours ago

Stalled...? I even had to look up the name using "pgp social network xlm" as search terms.

App still working tho.

nasretdinov•1 day ago

You can also have multiple independent git repos that don't duplicate the full object store, via git clone --reference. It's less relevant in the container era, but otherwise it can save a lot of time and disk space when cloning repos repeatedly

packetlost•1 day ago

Oh, that's actually really useful for my... inefficient clone of nixpkgs and the linux kernel...

yjftsjthsd-h•about 22 hours ago

Interesting; how's it compare to work trees?

nasretdinov•about 7 hours ago

Worktrees are different checkouts of the same repo. Clone with --reference is a separate repo altogether, with its own .git and worktree.

mystifyingpoi•1 day ago

What's the purpose of this? I don't get it. Why push at all to "local remote", if you can just keep your changes on a local branch, and push it whenever "remote remote" becomes available again?

pokstad•1 day ago

I use this to push changes to a local encrypted sparse bundle image, and then I periodically rsync that image to a remote disk. Git has no built in encrypted storage, so pushing directly to a remote means you trust that remote.

chrstphmr•about 24 hours ago

To synchronize with coding agents isolated in KVM/QEMU VMs, I use local bare repos under /home/git/ on the host.

git user is restricted to git-shell and the agent has a passwordless SSH key to access git@host:/home/git/project.git. On the host, I push/pull to git@localhost:/home/git/project.git (sidestepping fiddling with git safe.directory settings for each project).

Seemed like an easy way for local sync without giving the untrusted VM access to a writable shared filesystem?

tracker1•1 day ago

Depends on if/how you're communication and/or working with others... lets say github/devops/whatever is down... but you're still wanting to get work done and collaborating with other devs.

Being able to target a shared SSH server in your control while the upstream service is down is pretty freeing... and even if you aren't releasing to production/test/etc, you can keep making shared progress.. even more important with trunk based development.

mystifyingpoi•1 day ago

But "shared SSH server" isn't local.

tracker1•about 12 hours ago

Define local... Is the same room you are in local?

adregan•1 day ago

A decade ago I was working with an intern who wasn’t allowed access to push to any branch. As I wanted him to get experience with the development cycle, I set up a bare repo in a shared Dropbox folder and had him push code there.

Aside from that unique use case, I might consider this for storing code on a network attached drive (archival).

ok123456•1 day ago

I use local remotes all the time for testing as a form of "local CI".

Check it out from '/tmp' and make sure it still builds.

For a single-dev or small team, it beats having to do github runner epicycles to accomplish the same basic goal. Add in Firejail if you want environment isolation.

mook•1 day ago

Would git worktrees be useful in that use case? It just adds a new checkout in a different directory without duplicating the git data (blob storage).

gcarvalho•1 day ago

I do the same sometimes, but a one-off clone is not quite the same as maintaining a "local remote" and pushing refs to it.

ok123456•1 day ago

If it fails, you fix the clone and push it back.

ulrikrasmussen•1 day ago

I am also seriously puzzled and don't see the point. Why push to a local remote if the real remote is not reachable? The branch is still not leaving your machine, you are just making a copy of it in another place and now have to manage `local/` refs in addition to `origin/`.

weaksauce•1 day ago

It's useful for me to have a "production" website remote that i just run on my computer for myself locally. rsync could also work but tagging with rollbacks make it easier if something goes wrong. it's not a common thing but it's nice to have that as an option. just because you can't see the utility of it doesn't make it useless

ulrikrasmussen•1 day ago

True, but TFA did not actually present any use cases.

fwip•1 day ago

"local" can also be a network fileshare. It could also be in a directory that is treated differently than your other checkouts - whether that's something like deployment, sharing over the web, running CI, etc.

mystifyingpoi•1 day ago

"network fileshare" is not local. By the same logic, I can mount S3 bucket over fuse and call it "local". Sure, it will work, but in the context it is just nonsense.

ulrikrasmussen•1 day ago

I doubt it is safe to concurrently modify a git repo over a fileshare though. I don't understand the other use cases you mention

tonypapousek•1 day ago

I reckon most folks have made a git oopsie and needed to re-clone a repo at least once in their career.

Having a “local remote” would be an awfully quick way to do that, especially in situations with no/low network connection or a flakey upstream server.

bregma•1 day ago

> I reckon most folks have made a git oopsie and needed to re-clone a repo at least once in their career.

And I recon this is the default workflow for most people most of the time.

newsoftheday•1 day ago

For my selfhosting, I use local remotes the same as if I were using Github or Gitlab, as part of my CI tools chain, using a git hook script to kick off the Jenkins build on the remote directory. Everything is backed up daily and monthly (separately).

m463•1 day ago

I've used it to quickly start a git project, with source control, no credentials to deal with, etc

eventually I can set up a proper git repo, set up credentials, etc.

I think it's like how some people use 127.0.0.1 for stuff, then later expand the software engineering process to do it right.

adastra22•1 day ago

I don’t understand. A proper git repo is… your git repo. Git is distributed.

I have lots of projects under for version control with no remotes.

m463•about 23 hours ago

I don't know, I just have one or more clones of this "local repo" and have no trouble blowing the clones away and starting over.

backup? peace of mind?

mystifyingpoi•1 day ago

I can imagine it being useful for some obscure setup of local CI (like Jenkins) that expects a Git URL and for whatever reason cannot just copy files from one directory to another. Or maybe Argo/Flux tinkering to mimic real repo. But nothing usual should require such tricks.

leephillips•1 day ago

Yeah, I don’t get it either. The command is `git init` and you’re done.

pglevy•1 day ago

I recently did a similar thing to get all my private repos off GitHub while keeping the same git workflows and accessibility for other machines on my home network. Now my Pi is the remote for those repos.

XorNot•1 day ago

Within certain bounds git behaves quite nicely with a directory of bare git repos and Syncthing.

dist-epoch•1 day ago

I use this to work with multiple agents in multiple sandboxes - they push to the local remote instead of GitHub which is now unreliable.

And I push to GitHub/GitLab from a repo outside the sandboxes.

codepack•about 7 hours ago

In my experience, local remotes shine when you have multiple clones of the same repo on the same machine (e.g., different working trees) and you want to share objects without re-downloading or using symlinks. Also, for quick offline backups: `git push /mnt/backup/repo.git --all` is dead simple. To answer mystifyingpoi's question, one reason to push to a local remote is if you want a separate copy that isn't affected by your branch naming—or if you're using multiple clients (like a work and personal repo) that need to sync when network is available later.

joeyguerra•1 day ago

I love reading articles like this. It's kinda of a slap in the face – "hey guys, you know that thing you've been doing for decades, well for decades you've had this ability to do it with your own stuff if you just spend a few human brain tokens on it".

btw, Git also supports the HTTP protocol ...

chriswarbo•1 day ago

> btw, Git also supports the HTTP protocol ...

In fact, Git supports any protocol! If you add a git remote like

    git remote add my-remote my-super-duper-protocol::some-sort-of-address-thingy

Then pushing/pulling `my-remote` will try to invoke a command called `git-remote-my-super-duper-protocol`, with `some-sort-of-address-thingy` in its arguments. You can implement that however you like.

I use remotes like "pkipfs::y5a9inx61aski4miz4sgmg55qgbazxhfwab3i6ee1ypa6rnumi8o", which invokes a custom git-remote-pkipfs command that pushes/pulls object data to IPFS and resolves/updates refs as subdomains of a specified pkarr address.

jjice•1 day ago

While yeah it's a thing that many people already are familiar with, I don't think it hurts to push out these concepts once and a while to help spread info to recalibrate those who hadn't learned these yet. I'd rather we have a bunch of articles explaining git specifics than a bunch of engineers that don't know the difference between git and GitHub.

antiframe•1 day ago

GitHub has been such a staple of the modern dev that some are now (re)discovering git is distributed.

alsobrsp•1 day ago

Everything old is new again. I wouldn't be surprised if there were people that thought GitHub invented git.

elevation•1 day ago

> thought GitHub invented git

Putting the generic term into your corporation's name can be effective means of claiming things that don't belong to you.

Jon Postel reserved 44.0.0.0/8 for a generic purpose: "amateur radio digital communications." Decades later, there was a successful heist when some enterprising individuals who had incorporated "Amateur Radio Digital Communications" misrepresented to ARIN that the assignment had actually been theirs. Immediately after ARIN gave them transfer rights, they pocketed 8 figures reselling the space to Amazon.

Github obviously isn't making explicit claims like this but they benefit whenever people with purchasing power implicitly understand that github is the only option.

edited: Amateur Radio Digital Communications is not an LLC

neuronexmachina•1 day ago

Do you have a source for your claims about the ARDC?

orev•1 day ago

That assumption has come up in almost every conversation I’ve ever had with semi-technical people regarding git, so the confusion is just a fact. It happens so often, I think Linus (or whoever controlled the git trademarks at the time) should have demanded GitHub change their name when it was launched.

enoint•1 day ago

More precisely, a movement to leave GitHub mistakenly endeavors to leave git.

jjice•1 day ago

I know so many people I went to school with and have worked with that _still_ couldn't tell you the difference between git and GitHub.

tardedmeme•1 day ago

I don't think I've ever met a programmer online who didn't think git and github were the same thing.

wanzg•1 day ago

One of my younger colleagues indeed displayed a mistaken impression of that kind last week.

dogscatstrees•about 21 hours ago

Nice. Claude likes it, especially when the AI detects PII and knows by policy to halt the commit to cloud but not local.

> A related trick worth knowing — one git push can fan out to two destinations:

git remote set-url --add --push origin ~/bares/<repo>.git # add a 2nd push URL # now `git push origin` writes to GitHub AND the local bare repo

barnabee•1 day ago

I do this to a ~/git-sync/<project>.git directory that's synced over Syncthing for all my personal projects it's great.

ucirello•1 day ago

That's what I used to do with git (just recently moved off of SVN) in a shared computer predating github. It works very well!

joseph•about 22 hours ago

Sometimes I do this if I want to cherry pick commits from another repo already on my machine. Add the other repo as a local remote and then I can "import" that code while keeping its history in the new repo.

cerved•1 day ago

you can also setup a local remote which hardlinks the index so it doesn't occupy more space. Why? Idk. You don't want to share stash, rerere-cache, branches whatever.

Also handy if you're running an agent in a container on the local fs. Set up a local clone, contain the agent to that repo folder and have it hack away on that. Later, you step out of the container and do the syncing. You can't use worktrees in this situations.

Bare repos are also pretty cool. You can clone the git mailing list as a bare repo and search for threads there instead of setting up an mbox (same for the kernel obviously)

fphilipe•1 day ago

At that point you might as well use a worktree[1].

[1]: https://git-scm.com/docs/git-worktree

sciolizer•about 23 hours ago

You can't use a worktree without write access to the shared object database. You can use worktrees, or you can containerize your agents, but you can't do both.

sciolizer•about 23 hours ago

> hardlinks the index

I think you mean hardlinks the object database? The index (staging area) changes constantly. Not much point in hardlinking it.

Hardlinking the object database is the default behavior with you clone locally on linux. It's great for one-off clones such as CI/CD pipelines and agentic containers, but the benefit in terms of disk space saved is short-lived: as repos evolve independently, they replace their packfiles with new ones, and the new ones will not be hardlinked because they don't contain the same objects.

I like to keep bare repositories in dropbox, but I use `--no-hardlinks` when cloning, because before I did that, on one occasion, dropbox corrupted the bare repo, and my working repo was corrupted as a result.

cyanydeez•1 day ago

which harness has actual containment controls and not just suggestions?

tuyiown•about 22 hours ago

    git push . <branch1>:<branch2>
    git pull . <branch2>:<branch1>

whax•1 day ago

Interesting that the footer of the page contains the magic string Anthropic provides to trigger model refusal (styled small and clear).

enoint•1 day ago

It’s hard to sincerely bring up things like site-to-site VPN, without condescending.

shmerl•about 23 hours ago

Can it work with file://?

js2•about 23 hours ago

Yes:

    $ git init foo
    Initialized empty Git repository in .../foo/.git/
    $ git clone "file://$PWD/foo" bar
    Cloning into 'bar'...

But it's redundant:

   $ git clone bar baz    
   Cloning into 'baz'...

If you example .git/config in either clone, you'll see that remote.origin.url is the absolute path of the source repo.

Note that you can share objects across clones on the same machine in various ways. See "--local", "--shared", and "--reference" in the git-clone man page. (GitHub uses this feature heavily. Or at least they did. I have no idea what their backend implementation is these days, but they must be doing some sort of copy-on-write CAS for forks.)

globular-toast•1 day ago

A "local remote" is a contradiction. Unless the remote is on a different disk you are just wasting space. Even then the point of remotes is for sharing, not for backup/redundancy.

orev•1 day ago

What if you have a few local machines you’re using for development, and want to keep them in sync? This method allows that single central repo without having to bounce all the code through a cloud hosting service.

globular-toast•1 day ago

OK, different meanings of word "local". TFA uses "local" to mean the same machine, not the same local network.

Zambyte•1 day ago

The remote can be a shared directory that multiple users have access to, and the working directory is private where each user only has private read + write access.

cowmix•1 day ago

I use them ALL THE TIME. If anything, I have my 'local remote' in my Syncthing shared dir - its great for sharing code between my dev workstation(s) w/o using Github, etc.