hedgedoc/docs/content/config/media/imgur.md

# Imgur

!!! warning "Imgur saves anonymous images for only 6 month"
    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](https://help.imgur.com/hc/en-us/articles/14415587638029-Imgur-Terms-of-Service-Update-April-19-2023-)

You can use [Imgur](https://imgur.com) to handle your image uploads in HedgeDoc.

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>
3. Fill out the form and choose "Anonymous usage without user authorization" as the authorization type.
4. Imgur will then show you your client id.

Then you just add the following lines to your configuration:  
<small>(with the appropriate substitution for `<IMGUR_CLIENT_ID>` of course)</small>
```
HD_MEDIA_BACKEND="imgur"
HD_MEDIA_BACKEND_IMGUR_CLIENT_ID="<IMGUR_CLIENT_ID>"
```

All uploads are saved in the `media_uploads` database table and contain the deletion token ([see here](https://apidocs.imgur.com/#949d6cb0-5e55-45f7-8853-8c44a108399c)) in the column `backendData`.
Docs: Add Azure, Filesystem, Imgur and S3 Signed-off-by: Philip Molares <philip.molares@udo.edu> 2021-02-28 11:46:00 -05:00			`# Imgur`

docs(imgur): add warning about new imgur policy Because imgur will delete images 6 month after the last access, we should tell our users about this change to help them make a informed decision about their media backend choice… Signed-off-by: Philip Molares <philip.molares@udo.edu> 2023-05-07 15:54:38 -04:00			`!!! warning "Imgur saves anonymous images for only 6 month"`
docs: indent imgur warning correctly Signed-off-by: Philip Molares <philip.molares@udo.edu> 2023-05-10 07:41:00 -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](https://help.imgur.com/hc/en-us/articles/14415587638029-Imgur-Terms-of-Service-Update-April-19-2023-)`
docs(imgur): add warning about new imgur policy Because imgur will delete images 6 month after the last access, we should tell our users about this change to help them make a informed decision about their media backend choice… Signed-off-by: Philip Molares <philip.molares@udo.edu> 2023-05-07 15:54:38 -04:00
Docs: Add Azure, Filesystem, Imgur and S3 Signed-off-by: Philip Molares <philip.molares@udo.edu> 2021-02-28 11:46:00 -05:00			`You can use [Imgur](https://imgur.com) to handle your image uploads in HedgeDoc.`

			`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>`
			`3. Fill out the form and choose "Anonymous usage without user authorization" as the authorization type.`
			`4. Imgur will then show you your client id.`

			`Then you just add the following lines to your configuration:`
			<small>(with the appropriate substitution for `<IMGUR_CLIENT_ID>` of course)</small>
			```
			`HD_MEDIA_BACKEND="imgur"`
			`HD_MEDIA_BACKEND_IMGUR_CLIENT_ID="<IMGUR_CLIENT_ID>"`
			```

			All uploads are saved in the `media_uploads` database table and contain the deletion token ([see here](https://apidocs.imgur.com/#949d6cb0-5e55-45f7-8853-8c44a108399c)) in the column `backendData`.