High performance self-hosted photo and video management solution.
 
 
 
 
 
 
Go to file
Robert Schäfer 146bf65d02
refactor(dev): remove ulimits for rootless docker (#24393)
Description
-----------

When I follow the [developer setup](https://docs.immich.app/developer/setup) I run into a permission error using rootless docker. A while ago I asked on Discord in [#contributing](https://discord.com/channels/979116623879368755/1071165397228855327/1442974448776122592) about these ulimits.

I suggest to remove the `ulimits` altogether. It seems that @ItalyPaleAle has left the setting just hoping that it could help somebody in the future. See the [PR description](https://github.com/immich-app/immich/pull/4556).

How Has This Been Tested?
-------------------------

Using rootless docker:

```
$ docker context ls
NAME         DESCRIPTION                               DOCKER ENDPOINT                     ERROR
default                                                unix:///var/run/docker.sock
rootless *                                             unix:///run/user/1000/docker.sock
```

Running `make` will fail because of permission errors:
```
$  docker compose -f ./docker/docker-compose.dev.yml up --remove-orphans
...
Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: error during container init: error setting rlimits for ready process: error setting rlimit type 7: operation not permitted
```

On my machine I have the following hard limit for "Maximum number of open file descriptors":
```
$ ulimit -nH
524288
```

I can confirm that the permission error is caused by the security restrictions of the operating system mentioned above:

Changing `docker/docker-compose.dev.yml` like ..

```
    ulimits:
      nofile:
        soft: 524289
        hard: 524289
```

.. will lead to a permission error whereas this ..

```
    ulimits:
      nofile:
        soft: 524288
        hard: 524288
```

.. starts fine.

Apparently the defaults for these limits are coming from [systemd](26b2085d54/man/systemd.exec.xml (L1122)) which is used on nearly every linux distribution. So my assumption is that almost any linux user who uses rootless docker will run into a permission error when starting the development setup.

Checklist:
----------

- [x] I have performed a self-review of my own code
- [x] I have made corresponding changes to the documentation if applicable
- [x] I have no unrelated changes in the PR.
- [ ] I have confirmed that any new dependencies are strictly necessary.
- [ ] I have written tests for new code (if applicable)
- [ ] I have followed naming conventions/patterns in the surrounding code
- [ ] All code in `src/services/` uses repositories implementations for database calls, filesystem operations, etc.
- [ ] All code in `src/repositories/` is pretty basic/simple and does not have any immich specific logic (that belongs in `src/services/`)
2025-12-05 09:26:20 +07:00
.devcontainer feat(server): support running medium tests in devcontainer (#23882) 2025-11-18 21:03:21 +07:00
.github fix: prettier (#24386) 2025-12-04 16:10:42 +07:00
.vscode chore(deps): update dependency eslint-plugin-unicorn to v62 (#24167) 2025-11-27 21:31:16 +07:00
cli fix: prettier (#24386) 2025-12-04 16:10:42 +07:00
deployment chore(deps): update dependency opentofu to v1.10.7 (#23964) 2025-11-28 14:41:23 +07:00
design chore: update readme screenshot (#8182) 2024-03-22 04:31:36 +07:00
docker refactor(dev): remove ulimits for rootless docker (#24393) 2025-12-05 09:26:20 +07:00
docs fix: prettier (#24386) 2025-12-04 16:10:42 +07:00
e2e fix: prettier (#24386) 2025-12-04 16:10:42 +07:00
fastlane
i18n feat: header context menu (#24374) 2025-12-04 11:09:38 +07:00
machine-learning chore(deps): update machine-learning (#24334) 2025-12-02 01:01:17 +07:00
misc/release fix: pump-version.sh flags (#23848) 2025-11-12 17:47:52 +07:00
mobile fix: use adjustment time in iOS for hash reset (#24047) 2025-12-03 21:15:58 +07:00
open-api chore: change workflow column name (#24349) 2025-12-02 14:40:17 +07:00
plugins fix(deps): update typescript-projects (#24163) 2025-11-25 17:26:36 +07:00
readme_i18n docs: sync ru docs with main README.md (#23627) 2025-11-05 08:05:03 +07:00
server feat: sql tools array as default value (#24389) 2025-12-04 12:54:20 +07:00
web fix: prettier (#24386) 2025-12-04 16:10:42 +07:00
.dockerignore chore: dockerfile layout changes (#19673) 2025-07-18 17:56:26 +07:00
.editorconfig
.gitattributes chore: do not render drift migration auto gen files (#20060) 2025-07-21 16:48:22 +07:00
.gitignore chore(mobile): ignore ios build folder (#22212) 2025-09-19 09:50:24 +07:00
.gitmodules chore: update submodule (#11789) 2024-08-14 22:06:11 +07:00
.pnpmfile.cjs fix: isolate docker host/container filesystem for node_modules and build output (#21167) 2025-08-24 13:09:45 +07:00
CODEOWNERS chore: add mobile codeowner (#22130) 2025-09-17 14:08:35 +07:00
CODE_OF_CONDUCT.md Added Code of conduct 2024-07-05 15:31:13 +07:00
LICENSE
Makefile feat: run e2e server in dev mode (#23921) 2025-11-17 14:16:39 +07:00
README.md fix(docs): update Readme links (#23959) 2025-11-18 21:32:11 +07:00
SECURITY.md chore: use immich.app email for security reports (#10594) 2024-06-24 07:25:48 +07:00
install.sh fix: bash install.sh script for mac os (#15874) 2025-02-03 16:41:42 +07:00
mise.toml fix(deps): update typescript-projects (#24329) 2025-12-02 23:28:12 +07:00
package.json fix(deps): update typescript-projects (#24329) 2025-12-02 23:28:12 +07:00
pnpm-lock.yaml fix: prettier (#24386) 2025-12-04 16:10:42 +07:00
pnpm-workspace.yaml chore: update sharp to 0.34.5 (#24170) 2025-11-27 15:13:16 +07:00
renovate.json fix: disable ruby updates (#23794) 2025-11-11 14:51:21 +07:00

README.md


License: AGPLv3 Discord

High performance self-hosted photo and video management solution



Català Español Français Italiano 日本語 한국어 Deutsch Nederlands Türkçe 简体中文 正體中文 Українська Русский Português Brasileiro Svenska العربية Tiếng Việt ภาษาไทย

[!WARNING] ⚠️ Always follow 3-2-1 backup plan for your precious photos and videos!

[!NOTE] You can find the main documentation, including installation guides, at https://immich.app/.

Demo

Access the demo here. For the mobile app, you can use https://demo.immich.app for the Server Endpoint URL.

Login credentials

Email Password
demo@immich.app demo

Features

Features Mobile Web
Upload and view videos and photos Yes Yes
Auto backup when the app is opened Yes N/A
Prevent duplication of assets Yes Yes
Selective album(s) for backup Yes N/A
Download photos and videos to local device Yes Yes
Multi-user support Yes Yes
Album and Shared albums Yes Yes
Scrubbable/draggable scrollbar Yes Yes
Support raw formats Yes Yes
Metadata view (EXIF, map) Yes Yes
Search by metadata, objects, faces, and CLIP Yes Yes
Administrative functions (user management) No Yes
Background backup Yes N/A
Virtual scroll Yes Yes
OAuth support Yes Yes
API Keys N/A Yes
LivePhoto/MotionPhoto backup and playback Yes Yes
Support 360 degree image display No Yes
User-defined storage structure Yes Yes
Public Sharing Yes Yes
Archive and Favorites Yes Yes
Global Map Yes Yes
Partner Sharing Yes Yes
Facial recognition and clustering Yes Yes
Memories (x years ago) Yes Yes
Offline support Yes No
Read-only gallery Yes Yes
Stacked Photos Yes Yes
Tags No Yes
Folder View Yes Yes

Translations

Read more about translations here.

Translation status

Repository activity

Activities

Star history

Star History Chart

Contributors