evcc Docker & Self-Hosted Deployment

GitHub

Go battery & charger repository by @evcc-io. AI agent rules & system prompts with 7.4k stars.

7,399 stars Go Go 1 file · ~5,086 tokens #battery#charger#eebus#emobility#golang#home-automation#modbus#mqtt
1. Pull Image (DOCKERHUB) docker pull evcc-io/evcc:latest
2. Docker Run (1-Click Launch) docker run -d --name evcc -p 5353:5353 --restart always evcc-io/evcc:latest
3. Podman Run podman run -d --name evcc -p 5353:5353 --restart always evcc-io/evcc:latest
4. Skopeo Inspect (Zero-Pull Manifest) skopeo inspect docker://docker.io/evcc-io/evcc:latest
5. ORAS Pull (OCI Artifact) oras pull evcc-io/evcc:latest
Dockerfile 
# STEP 1 build ui
FROM --platform=$BUILDPLATFORM ghcr.io/voidzero-dev/vite-plus:1.3.0@sha256:61860c1b58bf35878605280802809973c668f1594675298c3be553a98ac06e59 AS node

USER root

WORKDIR /build

# install node tools
COPY .node-version package*.json ./
RUN --mount=type=cache,target=/root/.npm npm ci

# build ui
COPY Makefile .
COPY *.js ./
COPY *.ts *.mts ./
COPY .browserslistrc .
COPY assets assets
COPY i18n i18n

RUN make ui


# STEP 2 build executable binary
FROM --platform=$BUILDPLATFORM golang:1.27.1-alpine AS builder

# Install git + SSL ca certificates.
# Git is required for fetching the dependencies.
# Ca-certificates is required to call HTTPS endpoints.
RUN apk update && apk add --no-cache git make patch tzdata ca-certificates && update-ca-certificates

# define RELEASE=1 to hide commit hash
ARG RELEASE=0

WORKDIR /build

# Setup Go cache
ENV GOCACHE=/root/.cache/go-build
ENV GOMODCACHE=/root/.cache/go-mod

# download modules
COPY go.mod .
COPY go.sum .
RUN --mount=type=cache,target=${GOMODCACHE} go mod download

# install tools
COPY Makefile .
COPY cmd/implement/ cmd/implement/
COPY api/ api/
RUN --mount=type=cache,target=${GOMODCACHE} --mount=type=cache,target=${GOCACHE} make install

# prepare
COPY . .
RUN make patch-asn1
RUN --mount=type=cache,target=${GOMODCACHE} --mount=type=cache,target=${GOCACHE} make assets

# copy ui
COPY --from=node /build/dist /build/dist

# build
ARG TARGETOS
ARG TARGETARCH
ARG TARGETVARIANT
ARG GOARM=${TARGETVARIANT#v}

RUN --mount=type=cache,target=${GOCACHE} --mount=type=cache,target=${GOMODCACHE} \
    RELEASE=${RELEASE} GOOS=${TARGETOS} GOARCH=${TARGETARCH} GOARM=${GOARM} make build


# STEP 3 build a small image including module support
FROM alpine:3.23@sha256:5b10f432ef3da1b8d4c7eb6c487f2f5a8f096bc91145e68878dd4a5019afde11

WORKDIR /app

ENV TZ=Europe/Berlin

# Import from builder
COPY --from=builder /usr/share/zoneinfo /usr/share/zoneinfo
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
COPY --from=builder /build/evcc /usr/local/bin/evcc

COPY packaging/docker/bin/* /app/

# mDNS
EXPOSE 5353/udp
# EEBus
EXPOSE 4712/tcp
# mDNS
EXPOSE 5353/udp
# UI and /api
EXPOSE 7070/tcp
# KEBA charger
EXPOSE 7090/udp
# EVSE Master charger
EXPOSE 28376/udp
# OCPP charger
EXPOSE 8887/tcp
# Modbus UDP
EXPOSE 8899/udp
# SMA Energy Manager
EXPOSE 9522/udp

HEALTHCHECK \
  --interval=30s \
  --timeout=5s \
  --start-period=30s \
  --retries=3 \
  CMD wget -qO /dev/null http://localhost:7070 || exit 1

ENTRYPOINT [ "/app/entrypoint.sh" ]
CMD [ "evcc" ]