2021-02-28 11:46:00 -05:00
|
|
|
# Imgur
|
|
|
|
|
|
2023-05-07 15:54:38 -04:00
|
|
|
!!! warning "Imgur saves anonymous images for only 6 month"
|
2023-07-05 20:45:32 -04:00
|
|
|
Imgur will delete images not associated with any account 6 month after the last access.
|
|
|
|
|
This means that if you use imgur as your image backend, you may lose images
|
|
|
|
|
uploaded by you or your users. See this [FAQ entry][faq-entry]
|
2023-05-07 15:54:38 -04:00
|
|
|
|
2023-07-05 20:45:32 -04:00
|
|
|
You can use [Imgur][imgur] to handle your image uploads in HedgeDoc.
|
2021-02-28 11:46:00 -05:00
|
|
|
|
|
|
|
|
All you need for that is to register an application with Imgur and get a client id:
|
|
|
|
|
|
|
|
|
|
1. Create an account on imgur.com and log in.
|
|
|
|
|
2. Go to <https://api.imgur.com/oauth2/addclient>
|
2023-07-05 20:45:32 -04:00
|
|
|
3. Fill out the form and choose "Anonymous usage without user authorization"
|
|
|
|
|
as the authorization type.
|
2021-02-28 11:46:00 -05:00
|
|
|
4. Imgur will then show you your client id.
|
|
|
|
|
|
|
|
|
|
Then you just add the following lines to your configuration:
|
2023-07-05 20:45:32 -04:00
|
|
|
(with the appropriate substitution for `<IMGUR_CLIENT_ID>` of course)
|
|
|
|
|
|
|
|
|
|
```dotenv
|
2021-02-28 11:46:00 -05:00
|
|
|
HD_MEDIA_BACKEND="imgur"
|
|
|
|
|
HD_MEDIA_BACKEND_IMGUR_CLIENT_ID="<IMGUR_CLIENT_ID>"
|
|
|
|
|
```
|
|
|
|
|
|
2023-07-05 20:45:32 -04:00
|
|
|
All uploads are saved in the `media_uploads` database table and contain the deletion token
|
|
|
|
|
([see here][deletion-token]) in the column `backendData`.
|
|
|
|
|
|
|
|
|
|
[faq-entry]: https://help.imgur.com/hc/en-us/articles/14415587638029-Imgur-Terms-of-Service-Update-April-19-2023
|
|
|
|
|
[imgur]: https://imgur.com
|
|
|
|
|
[deletion-token]: https://apidocs.imgur.com/#949d6cb0-5e55-45f7-8853-8c44a108399c
|
