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

# Self-hosting with Hostim.dev

> Deploy Sure on Hostim.dev with a managed database, Redis, persistent storage, and automatic HTTPS

[Hostim.dev](https://hostim.dev) is a managed container-hosting platform that runs Sure with a managed PostgreSQL database, managed Redis, persistent storage, and automatic HTTPS. You don't need to provision or maintain a server.

## One-click deploy

Sure is available as a one-click template on Hostim.dev. It provisions the Rails web server, the Sidekiq background worker, PostgreSQL, and Redis, and generates `SECRET_KEY_BASE` automatically.

1. Open the [Sure template](https://console.hostim.dev/dashboard?preview=1\&modal=1\&template=sure).
2. Choose a resource plan.
3. Click **Deploy**.
4. Open the generated domain and create your first account.

A full walkthrough is available in the [Hostim.dev Sure guide](https://hostim.dev/docs/templates/sure).

## Manual setup

To configure the app yourself, create an app from the `ghcr.io/we-promise/sure:stable` image and set the following environment variables:

| Variable                                              | Value                                                     |
| ----------------------------------------------------- | --------------------------------------------------------- |
| `SECRET_KEY_BASE`                                     | A long random hex string. Keep it stable across restarts. |
| `DB_HOST` / `DB_PORT`                                 | Your PostgreSQL host and port.                            |
| `POSTGRES_DB` / `POSTGRES_USER` / `POSTGRES_PASSWORD` | Database credentials.                                     |
| `REDIS_URL`                                           | `redis://<host>:<port>/1`                                 |
| `SELF_HOSTED`                                         | `true`                                                    |

Run the web server and a Sidekiq worker from the same image, both sharing the same `SECRET_KEY_BASE`. Run `bin/rails db:prepare` before the web server starts so migrations are applied. For example, use a start command like:

```bash theme={null}
sh -c "./bin/rails db:prepare && (bundle exec sidekiq &) && exec ./bin/rails server -b 0.0.0.0"
```

Mount a persistent volume at `/rails/storage`. Sure stores uploaded files (such as imported statements) there via Active Storage's local disk service by default. Without a persistent volume, uploaded files are lost when the container is replaced, while the database still references them.