Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

blogpost: Migrating From Brave to IPFS Desktop #693

Merged
merged 22 commits into from
Aug 26, 2024
Merged

Conversation

lidel
Copy link
Member

@lidel lidel commented Aug 13, 2024

This is the migration guide we will publish when Brave's removal of Kubo (brave/brave-browser#37735) hits their stable channel (ETA Aug 22nd).

cc @autonome

@lidel lidel requested review from mishmosh and 2color August 13, 2024 13:35
@2color

This comment was marked as resolved.

@lidel
Copy link
Member Author

lidel commented Aug 13, 2024

In my mind this is one time event, will not matter after a month, so blog (or even a pinned discussion forum thread) is more appropriate place.
Not feeling strongly about it, let's draft it here, and we can decide where to publish once the time comes.

@lidel lidel changed the title blogpost: Migrating From Brave to Desktop App blogpost: Migrating From Brave to IPFS Desktop Aug 14, 2024
src/_blog/2024-brave-migration-guide.md Outdated Show resolved Hide resolved
src/_blog/2024-brave-migration-guide.md Outdated Show resolved Hide resolved
@lidel
Copy link
Member Author

lidel commented Aug 22, 2024

@autonome @2color @mishmosh
I've just pushed update with bit more polished content that explains what is happening and why.

brave v1.69.153 just hit the stable channel, so I think we should merge this blogpost ASAP, and expand/fix on it if necessary, but we need a linkable resource people can google.

Mind giving it a quick read and review? (feel free to make edits inline)

@lidel lidel marked this pull request as ready for review August 22, 2024 22:31
@autonome
Copy link
Contributor

autonome commented Aug 23, 2024

a few more comments now that this is much further along:

  • should include the date, since we know pretty close to when they'll ship shipped yesterday, Aug 22 https://brave.com/latest/

  • not saying anything about the reason why Brave is removing IPFS will open the door for imaginations to run wild with completely untrue things, so should add something like "we could not find a mutually agreeable set of terms", which is exactly what it was

  • should throw something in (maybe in faq) about merging/syncing, even if just a pointer, since it will inevitably be brought up by people who've got data in both places

lidel and others added 2 commits August 23, 2024 16:02
Co-authored-by: Daniel Norman <1992255+2color@users.noreply.github.com>
@lidel
Copy link
Member Author

lidel commented Aug 23, 2024

Applied feedback from reviews and expanded FAQ a bit: https://bafybeian2nr7sgjmobixoqya7qw5uyghlwnu5tf5tkjel54wtb5hkx3syq.on.fleek.co/_2024-brave-migration-guide/
Good enough to merge?

src/_blog/2024-brave-migration-guide.md Outdated Show resolved Hide resolved

First, we need to locate your Brave IPFS repository:

<!-- TODO: confirm these paths are valid -->
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is this part confirmed? output for mac for any file/dir with "ipfs" in the name is:

❯ rg -g '*ipfs*' --files ~/Library/Application\ Support/BraveSoftware
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/lejaflgbgglfaomemffoaappaihfligf/1.0.29/go-ipfs_v0.29.0_darwin-arm64
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/Default/Extensions/nibjojkomfdiaoajekhjakgkdhaomnch/3.1.0_0/icons/ipfs-logo-on.svg
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/Default/Extensions/nibjojkomfdiaoajekhjakgkdhaomnch/3.1.0_0/icons/brave-ipfs-logo-off.svg
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/Default/Extensions/nibjojkomfdiaoajekhjakgkdhaomnch/3.1.0_0/icons/brave-ipfs-logo-on.svg
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/Default/Extensions/nibjojkomfdiaoajekhjakgkdhaomnch/3.1.0_0/icons/ipfs-logo-off.svg
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/Default/Extensions/nibjojkomfdiaoajekhjakgkdhaomnch/3.1.0_0/icons/png/ipfs-logo-on_19.png
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/Default/Extensions/nibjojkomfdiaoajekhjakgkdhaomnch/3.1.0_0/icons/png/ipfs-logo-off_19.png
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/Default/Extensions/nibjojkomfdiaoajekhjakgkdhaomnch/3.1.0_0/icons/png/ipfs-logo-off_38.png
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/Default/Extensions/nibjojkomfdiaoajekhjakgkdhaomnch/3.1.0_0/icons/png/ipfs-logo-on_128.png
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/Default/Extensions/nibjojkomfdiaoajekhjakgkdhaomnch/3.1.0_0/icons/png/ipfs-logo-on_38.png
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/Default/Extensions/nibjojkomfdiaoajekhjakgkdhaomnch/3.1.0_0/icons/png/ipfs-logo-off_128.png
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/Default/Extensions/nibjojkomfdiaoajekhjakgkdhaomnch/3.1.0_0/dist/bundles/ipfs.bundle.js
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/Default/Extensions/nibjojkomfdiaoajekhjakgkdhaomnch/3.1.0_0/dist/popup/browser-action/ipfs-version.js
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/Default/Extensions/nibjojkomfdiaoajekhjakgkdhaomnch/3.1.0_0/dist/options/forms/ipfs-node-form.js
/Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/Default/Extensions/fpeoodllldobpkbkabpblcfaogecpndd/0.12.7_0/brave-ipfs.json

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FYI it looks to be at /Users/sgtpooki/Library/Application Support/BraveSoftware/Brave-Browser/brave_ipfs/config on mac

Copy link
Member Author

@lidel lidel Aug 23, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you! I looked at Windows and it also does not use /Default.
I've updated blogpost with updated paths + added examples of fully resolved ones.

src/_blog/2024-brave-migration-guide.md Outdated Show resolved Hide resolved

### Can Kubo be used instead?

Yes, advanced users who are comfortable with command-line can use [Kubo](https://docs.ipfs.tech/install/command-line/) instead of IPFS Desktop, and run it against a custom `IPFS_PATH` to run a headless daemon, or perform selective manual migration via CLI.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

could benefit to mention this also comes with ipfs-webui built in?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think it matters for the migration. WebUI does not support CAR import, nor IPNS key import/export, only CLI tools can be used for such low level migration.

lidel and others added 2 commits August 24, 2024 00:32
Co-authored-by: Russell Dempsey <1173416+SgtPooki@users.noreply.github.com>
confirmed linux/windows and macOS
---
title: 'Migrating from Brave to IPFS Desktop'
description: 'Complete Guide to Migrating Your IPFS Data'
date: 2024-08-22
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

TODO: update to actual publishing date

@2color
Copy link
Member

2color commented Aug 26, 2024

For a more specific header image, feel free to use this one:
brave-ipfs

lidel and others added 3 commits August 26, 2024 14:58
Co-authored-by: Daniel Norman <1992255+2color@users.noreply.github.com>
Co-authored-by: Daniel Norman <1992255+2color@users.noreply.github.com>
@lidel
Copy link
Member Author

lidel commented Aug 26, 2024

Ok, final preview: https://bafybeid76ycpf6bg6s42xicanyrhlaxzqbfvysi26kccr6rzexbj6foyha.on.fleek.co/_2024-brave-migration-guide/

Will ask for final proofread, but I'm going to merge it by EOD.

@lidel lidel merged commit 623d406 into main Aug 26, 2024
3 checks passed
@lidel lidel deleted the brave-migration-guide branch August 26, 2024 16:34
@lidel
Copy link
Member Author

lidel commented Aug 26, 2024

Merged. If you are late to review and find something to improve, please fix in a new PR 🙏

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants