# Redmine + Lutril: setup guide

> Lutril connects to your self-hosted Redmine through OAuth: you enter your Redmine base URL, then authorize Lutril from inside the app. A personal REST API key is supported as a manual fallback.

Source: https://www.lutril.com/integrations/redmine
Category: Project management
Auth: oauth
Last verified: 2026-06-17

---

## Setup

1. Enter your Redmine base URL in Lutril (for example https://redmine.yourcompany.com).
2. Click Connect Redmine in Lutril and complete the OAuth authorize prompt on your Redmine instance.
3. Fallback: a Redmine administrator enables the REST API under Administration, then Settings, then the API tab, by checking Enable REST API and saving.
4. Fallback: each user opens My account at /my/account and copies the API access key from the right-hand pane.
5. Fallback: paste that API key into Lutril instead of using OAuth.

## References

- [Redmine documentation](https://www.redmine.org/projects/redmine/wiki/Rest_api)
- [Redmine REST API reference](https://www.redmine.org/projects/redmine/wiki/Rest_api)
- [OAuth2 provider tracking issue](https://www.redmine.org/issues/24808)