> ## Documentation Index
> Fetch the complete documentation index at: https://docs.libredesk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploy on Railway

> One-click deploy Libredesk on Railway with managed PostgreSQL and Redis

[Railway](https://railway.com) provisions a Libredesk service alongside managed PostgreSQL and Redis from a single template. The database schema installs automatically on first deploy.

## Deploy

<a href="https://railway.com/deploy/libredesk?referralCode=4gdm5b&utm_medium=integration&utm_source=template&utm_campaign=generic" target="_blank" rel="noopener noreferrer">
  <img src="https://libredesk.io/railway-button.svg" alt="Deploy on Railway" />
</a>

<Steps>
  <Step title="Click Deploy on Railway">
    Sign in to Railway, then set `LIBREDESK_SYSTEM_USER_PASSWORD` in the deploy form. It must be at least 10 characters with uppercase, lowercase, numeric, and special characters (e.g. `MyPassword@123`).
  </Step>

  <Step title="Wait for the build">
    Railway provisions PostgreSQL, Redis, and the Libredesk app, and assigns a `*.up.railway.app` domain to the Libredesk service. The schema installs automatically on first boot.
  </Step>

  <Step title="Log in">
    Visit the assigned domain and sign in with:

    * **Email**: `System`
    * **Password**: the password from step 1
  </Step>
</Steps>

## Configuration

To override any Libredesk setting, add an environment variable under the **Libredesk** service's **Variables** tab. All variables use the `LIBREDESK_` prefix with double underscores (`__`) for nested keys.

| Setting                                      | Environment variable                      |
| -------------------------------------------- | ----------------------------------------- |
| Max attachment / request body size (bytes)   | `LIBREDESK_APP__SERVER__MAX_BODY_SIZE`    |
| Session lifetime                             | `LIBREDESK_APP__SERVER__SESSION_LIFETIME` |
| Log level (`debug`, `info`, `warn`, `error`) | `LIBREDESK_APP__LOG_LEVEL`                |

See the [full configuration reference](/getting-started/installation#configuration-via-environment-variables) for the complete list.

<Warning>
  Don't change the auto-injected database and Redis variables. Railway manages those references.
</Warning>

## Updating Libredesk

Redeploy the **Libredesk** service from the Railway dashboard. It pulls the latest image and runs any pending migrations on startup.