Create plaid.md #2419

Closed
Facinorous-420 wants to merge 2 commits from main into main
Facinorous-420 commented 2025-06-27 09:30:48 +08:00 (Migrated from github.com)

Added instructions on how to set up plaid with your self hosted instance

Added instructions on how to set up plaid with your self hosted instance
PrplHaz4 commented 2025-06-27 12:01:41 +08:00 (Migrated from github.com)

@Facinorous-420 - nice work!

I've been doing some troubleshooting on selfhosted Plaid Sync today because my synced transactions only go back 3mos. I'm not sure it's related but - it's probably important to also note that in order for Plaid webhooks to work, your selfhosted server needs to be accessible from external networks. I don't think you need to set anything up for webhooks in the Plaid dashboard.

You can clearly see here webhook requests started to succeed after exposing my instance to the internet.
image

@Facinorous-420 - nice work! I've been doing some troubleshooting on selfhosted Plaid Sync today because my synced transactions only go back 3mos. I'm not sure it's related but - it's probably important to also note that in order for Plaid webhooks to work, your selfhosted server needs to be accessible from external networks. I don't think you need to set anything up for webhooks in the Plaid dashboard. You can clearly see here webhook requests started to succeed after exposing my instance to the internet. ![image](https://github.com/user-attachments/assets/c3ca6a3d-4212-46a1-bc9a-2ea4b491fa08)
Facinorous-420 commented 2025-06-27 18:23:46 +08:00 (Migrated from github.com)

It's probably important to also note that in order for Plaid webhooks to work, your selfhosted server needs to be accessible from external networks. I don't think you need to set anything up for webhooks in the Plaid dashboard.

You are correct, your Maybe instance needs a FQD with SSL. Plaid does not work properly without this. I first tried a local domain with local SSL generated via mkcert, but of course Plaid doesn't have the DNS to see my custom domains so that didn't work.

It would be nice if we didn't have to expose our instances to the web, such as Actual is about to using Simplefin.

I can add a line regarding the need for external access, FQD, and SSL. :)

> It's probably important to also note that in order for Plaid webhooks to work, your selfhosted server needs to be accessible from external networks. I don't think you need to set anything up for webhooks in the Plaid dashboard. You are correct, your Maybe instance needs a FQD with SSL. Plaid does not work properly without this. I first tried a local domain with local SSL generated via mkcert, but of course Plaid doesn't have the DNS to see my custom domains so that didn't work. It would be nice if we didn't have to expose our instances to the web, such as Actual is about to using Simplefin. I can add a line regarding the need for external access, FQD, and SSL. :)
zachgoll commented 2025-06-27 22:53:34 +08:00 (Migrated from github.com)

Love it! Thanks for the guide, I think a lot of self hosting folks will find this useful.

We've mentioned several times across our channels that our internal team does not have the capacity to officially support self-hosted Plaid, so we can't accept this into the main codebase. That said, we'll move it over to Community discussions and anyone who's looking to learn how to configure Plaid can reference it there.

Love it! Thanks for the guide, I think a lot of self hosting folks will find this useful. We've mentioned several times across our channels that our internal team does not have the capacity to officially support self-hosted Plaid, so we can't accept this into the main codebase. That said, we'll move it over to Community discussions and anyone who's looking to learn how to configure Plaid can reference it there.
zachgoll commented 2025-06-27 22:55:33 +08:00 (Migrated from github.com)

@Facinorous-420 I just remembered that Github does not have a way to convert a Pull Request to a discussion, so I'm going to close this one out. I'd recommend copy/pasting this guide to a discussion.

@Facinorous-420 I just remembered that Github does not have a way to convert a Pull Request to a discussion, so I'm going to close this one out. I'd recommend copy/pasting this guide to a discussion.
Facinorous-420 commented 2025-06-27 23:23:02 +08:00 (Migrated from github.com)

@Facinorous-420 I just remembered that Github does not have a way to convert a Pull Request to a discussion, so I'm going to close this one out. I'd recommend copy/pasting this guide to a discussion.

Thanks. Created it here:
https://github.com/maybe-finance/maybe/discussions/2421

I must say, I was looking for a guide like this specifically in the docs of the repo because there was that docs folder.
It would be nice to have all documentation organized in 1 spot, rather than having it all over the place.

> @Facinorous-420 I just remembered that Github does not have a way to convert a Pull Request to a discussion, so I'm going to close this one out. I'd recommend copy/pasting this guide to a discussion. Thanks. Created it here: https://github.com/maybe-finance/maybe/discussions/2421 I must say, I was looking for a guide like this specifically in the docs of the repo because there was that docs folder. It would be nice to have all documentation organized in 1 spot, rather than having it all over the place.
PrplHaz4 commented 2025-06-28 10:25:38 +08:00 (Migrated from github.com)

@Facinorous-420 I just remembered that Github does not have a way to convert a Pull Request to a discussion, so I'm going to close this one out. I'd recommend copy/pasting this guide to a discussion.

Thanks so much Zach for embracing the open and self-hosted-ness while drawing a clear line and providing a place where the community can and should continue support.

> @Facinorous-420 I just remembered that Github does not have a way to convert a Pull Request to a discussion, so I'm going to close this one out. I'd recommend copy/pasting this guide to a discussion. Thanks so much Zach for embracing the open and self-hosted-ness while drawing a clear line and providing a place where the community can and should continue support.
jjmata commented 2025-07-25 04:35:56 +08:00 (Migrated from github.com)

Hey @Facinorous-420 ... would you be interested in sending this to a new community fork we're trying to get going? Want to re-submit this PR there?

I am sure we could do what you mention above now that we're not worried about the "commercial support" angle:

I must say, I was looking for a guide like this specifically in the docs of the repo because there was that docs folder.
It would be nice to have all documentation organized in 1 spot, rather than having it all over the place.

Hey @Facinorous-420 ... would you be interested in sending this to a new [community fork](https://github.com/we-promise/sure) we're trying to get going? Want to re-submit this PR there? I am sure we could do what you mention above now that we're not worried about the "commercial support" angle: > I must say, I was looking for a guide like this specifically in the docs of the repo because there was that docs folder. It would be nice to have all documentation organized in 1 spot, rather than having it all over the place.
Facinorous-420 commented 2025-07-25 04:40:03 +08:00 (Migrated from github.com)

Hey @Facinorous-420 ... would you be interested in sending this to a new community fork we're trying to get going? Want to re-submit this PR there?

I am sure we could do what you mention above now that we're not worried about the "commercial support" angle:

I must say, I was looking for a guide like this specifically in the docs of the repo because there was that docs folder.
It would be nice to have all documentation organized in 1 spot, rather than having it all over the place.

Sure :)
I'll make the PR I once I get home from work.

> Hey @Facinorous-420 ... would you be interested in sending this to a new [community fork](https://github.com/we-promise/sure) we're trying to get going? Want to re-submit this PR there? > > I am sure we could do what you mention above now that we're not worried about the "commercial support" angle: > > > I must say, I was looking for a guide like this specifically in the docs of the repo because there was that docs folder. > > It would be nice to have all documentation organized in 1 spot, rather than having it all over the place. Sure :) I'll make the PR I once I get home from work.
jjmata commented 2025-07-25 04:47:19 +08:00 (Migrated from github.com)

Thank you! I could have cherry-picked your commit ... but helps get the repo going with activity if people submit directly. :-)

Thank you! I could have cherry-picked your commit ... but helps get the repo going with activity if people submit directly. :-)

Pull request closed

Sign in to join this conversation.