# Other ways to install

Source: https://frameleaf.app/docs/start/other-install-methods/

On Synology, install the native **Frameleaf Manager** app with [Package Center → Manual Install](https://frameleaf.app/docs/nas/synology/). For other supported hosts, start with [Frameleaf Manager](https://frameleaf.app/docs/start/install/) for guided installation. Use [manual Docker Compose setup](https://frameleaf.app/docs/start/manual-install/) when you want to own the container configuration yourself.

Manual container routes use files and images from one matching [Frameleaf release](https://github.com/Frameleaf/frameleaf-app/releases). The Synology package installs Manager, which then installs the library from an eligible authenticated release.

## Portainer

1. Download `docker-compose.yml` and `example.env` from the [latest photo application release](https://github.com/Frameleaf/frameleaf-app/releases/latest).
2. In Portainer, create a **Stack** and paste the Compose file.
3. Replace the server's `.env` reference under `env_file` with `stack.env`. The machine learning service's optional `.env.ml` entry can stay as it is.
4. Add the release's environment variables in the stack editor. Set an absolute `UPLOAD_LOCATION`, a new `DB_DATA_LOCATION` on local disk and a random `DB_PASSWORD`.
5. Set `FRAMELEAF_VERSION=latest`, keep the database image supplied by the Compose file, then deploy.
6. Open the server on port `2283` and complete [First steps](https://frameleaf.app/docs/start/first-steps/).

If your editor only accepts one Compose file, copy the hardware settings you need straight into the service. See [Hardware acceleration](https://frameleaf.app/docs/admin/hardware-acceleration/#unraid-portainer-and-single-compose-files).

## Install script

The repository's `install.sh` is a small helper for a fresh manual installation. It creates a new `frameleaf-app` folder, downloads the latest release's Compose file and environment example, checks them against the release's checksums, generates a database password, and starts the stack. It requires Docker, Compose and `curl`.

Download and review the script from the release or source revision you want, then run it with Bash from a new parent directory. The script won't overwrite an existing `frameleaf-app` folder, which protects any library and database already there. Choose a new parent directory instead of deleting the old folder.

For control over storage paths before the first start, use the [manual guide](https://frameleaf.app/docs/start/manual-install/) instead.

## Containers running as a non-root user

The release's `docker-compose.rootless.yml` runs its services as user and group `1000:1000`. Use it in place of the regular Compose file. It sets the service user; your Docker daemon stays as it is.

Create the library, PostgreSQL, `ml-model-cache` and `studio-worker` host folders before starting it, owned by that user. A folder Docker creates for you is owned by root, so the services can't write to it. The rootless file has no network discovery helper, so type the server address in the phone apps. If you change the UID or GID, change it consistently in the Compose file and folder ownership. Keep the PostgreSQL parent mount at `/var/lib/postgresql`.

## NAS systems

**Synology:** obtain the released Frameleaf-supplied SPK and matching checksum, verify the file, then use **Package Center → Manual Install** on DSM 7.2.2-72806 or later with Container Manager 1432 or later. Open the app from the DSM main menu using the configured DSM HTTPS origin and create its administrator account. Library setup installs an eligible application release. See the [Synology guide](https://frameleaf.app/docs/nas/synology/).

**Unraid and TrueNAS:** follow the [Unraid](https://frameleaf.app/docs/nas/unraid/) or [TrueNAS](https://frameleaf.app/docs/nas/truenas/) guide and use the installation files supplied for your platform and release.

**HexOS:** paste the Frameleaf install script into **Custom Install**. A listing in the HexOS app catalog is coming soon. See the [HexOS guide](https://frameleaf.app/docs/nas/hexos/).

## A rented server

A Linux VM works with the same installation guides. Give it enough storage for originals, generated files and backups. Serve the app over HTTPS, and keep the database and Manager administration private. See [Reverse proxy](https://frameleaf.app/docs/admin/reverse-proxy/).

## Kubernetes and all-in-one images

Frameleaf installs with Manager or the release's Compose configuration. There's no supported Kubernetes chart or all-in-one image.
