Skip to content

Healthcheck not usable since replacement of IMMICH_PORT and IMMICH_HOST #624

Closed as not planned

Description

@loeffelpan

I would like to add a healthcheck to my container.
Something similar has been tried in #485, but there is no more activity

The desired way to do that is immich-healthcheck inside the container. This script is maintained by the immich team and already part of your image. It does use IMMICH_PORT (defaults to 2283) and IMMICH_HOST (defaults to localhost) if set.
Unfortunately it's not working due to a lack of IMMICH_PORT as default doesn't match your image.
IMMICH_PORT/HOST have been replaced by SERVER_PORT/HOST recently.

Maybe the easiest approach would be to set IMMICH_PORT and IMMICH_HOST as a copy of SERVER_PORT and SERVER_HOST if given?

Activity

  1. hydazz commented on Oct 24, 2025

    @hydazz
    Member

    a healthcheck can be achieved with (if using docker compose)

        healthcheck:
          test: ["CMD", "curl", "-f", "http://localhost:8080/ping"]
          interval: 30s
          timeout: 5s
          retries: 3
          start_period: 10s
    
  2. loeffelpan commented on Oct 24, 2025

    @loeffelpan
    Author

    I'm using that already, but this is not precise.
    The original healthcheck from immich does a little bit more and checks the returncode AND the content of the response. See here.

    Is there any problem adding those (original) environment variables to make healthcheck work as intended?

  3. imagegenius commented on May 18, 2026

    @imagegenius
    Contributor

    This issue has been marked as stale due to 60 days of inactivity. Please remove the stale label or leave a comment to keep it open.
    If no action is taken, it will be automatically closed in 7 days.

  4. imagegenius commented on May 27, 2026

    @imagegenius
    Contributor

    This issue has been automatically closed after 7 days of inactivity following the stale status.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions