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

website/integrations: added hoarder integration #12161

Merged
merged 22 commits into from
Dec 17, 2024
Merged
Show file tree
Hide file tree
Changes from 16 commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
b64e6f6
add Hoarder integration
shelldandy Nov 22, 2024
f690811
Update website/integrations/services/hoarder/index.md
shelldandy Nov 24, 2024
2b27fca
Update website/integrations/services/hoarder/index.md
shelldandy Nov 24, 2024
5a83cd9
Update website/integrations/services/hoarder/index.md
shelldandy Nov 24, 2024
ba225da
Update website/integrations/services/hoarder/index.md
shelldandy Nov 24, 2024
2ea5742
Update website/integrations/services/hoarder/index.md
shelldandy Nov 24, 2024
5bddfe1
Update website/integrations/services/hoarder/index.md
shelldandy Nov 24, 2024
99109f7
Update website/integrations/services/hoarder/index.md
shelldandy Nov 24, 2024
756071c
Update website/integrations/services/hoarder/index.md
shelldandy Nov 24, 2024
83a2ca0
hoarder sorted alphabetically
shelldandy Nov 24, 2024
9f0e951
more detailed way of using an application
shelldandy Nov 24, 2024
64a3ef2
Update index.md
shelldandy Nov 25, 2024
215de6e
Update index.md
shelldandy Nov 25, 2024
ce984e6
Update index.md
shelldandy Nov 25, 2024
8aa064f
Update index.md
shelldandy Nov 25, 2024
258ac32
Update index.md
shelldandy Nov 25, 2024
d1a01fe
Update website/integrations/services/hoarder/index.md
shelldandy Dec 3, 2024
357c58a
Update website/integrations/services/hoarder/index.md
shelldandy Dec 3, 2024
a9a81cf
Update website/integrations/services/hoarder/index.md
shelldandy Dec 3, 2024
2f83caa
test
rissson Dec 17, 2024
4519a6d
Merge branch 'main' into website/integrations/hoarder
Dec 17, 2024
573e04f
ran make website
Dec 17, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 56 additions & 0 deletions website/integrations/services/hoarder/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
title: Integrate with Hoarder
sidebar_label: Hoarder
---

# Hoarder

<span class="badge badge--secondary">Support level: Community</span>

## What is Hoarder

> A self-hostable bookmark-everything app (links, notes and images) with AI-based automatic tagging and full-text search.
>
> -- https://hoarder.app/

## Preparation

The following placeholders will be used:

- `hoarder.company` is the FQDN of the Hoarder install.
- `authentik.company` is the FQDN of the authentik install.

## Authentik configuration
shelldandy marked this conversation as resolved.
Show resolved Hide resolved

### Provider Settings
shelldandy marked this conversation as resolved.
Show resolved Hide resolved

In authentik, under **Applications** -> **Providers** of the **Admin interface**, create a new **OAuth2/OpenID Provider** with the desired settings.

- Name: `hoarder`
- Redirect URI: `https://hoarder.company/api/auth/callback/custom`

Everything else is up to you, just make sure to grab the client ID and the client secret!

### Application Settings
shelldandy marked this conversation as resolved.
Show resolved Hide resolved

In authentik, under **Applications** -> **Applications** of the **Admin interface**, create a new Application with the **Create** button that uses `hoarder` provider.
Optionally apply access restrictions to the application.

## Hoarder configuration

In Hoarder, you'll need to add these environment variables:

```sh
NEXTAUTH_URL=https://hoarder.company
OAUTH_CLIENT_ID=<Client ID from authentik>
OAUTH_CLIENT_SECRET=<Client secret from authentik>
OAUTH_WELLKNOWN_URL=https://authentik.company/application/o/hoarder/.well-known/openid-configuration
OAUTH_PROVIDER_NAME=authentik
OAUTH_ALLOW_DANGEROUS_EMAIL_ACCOUNT_LINKING=true
# Optional: You can add this if you only want to allow login with Authentik
# DISABLE_PASSWORD_AUTH=true
# Optional but highly recommended:
# DISABLE_SIGNUPS=true
```

Finally, restart the Hoarder server and test your configuration.
1 change: 1 addition & 0 deletions website/sidebarsIntegrations.js
Original file line number Diff line number Diff line change
Expand Up @@ -119,6 +119,7 @@ module.exports = {
"services/frappe/index",
"services/freshrss/index",
"services/gravitee/index",
"services/hoarder/index",
"services/home-assistant/index",
"services/immich/index",
"services/jellyfin/index",
Expand Down
Loading