skills/elixir-deploy/SKILL.md
Build and deploy Elixir and Phoenix applications — version detection, mix releases, and Dockerfile patterns. Use when deploying an Elixir or Phoenix project, or when mix.exs is detected.
npx skillsauth add nixopus/agent elixir-deployInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Project is Elixir if mix.exs exists in the root.
.elixir-version filemix.exs → detected from projectmise.toml or .tool-versions.erlang-version filemise.toml or .tool-versionsmix deps.get --only prod and mix deps.compilemix assets.setupmix assets.deploy and mix ecto.deploymix compile and mix release/app/_build/prod/rel/<app_name>/bin/<app_name> start
| Signal | Framework |
|---|---|
| mix.exs + phoenix dep | Phoenix |
| config/config.exs | Standard Elixir app |
| config/runtime.exs | Runtime config (prod) |
mix assets.setup and mix assets.deploymix ecto.setup (dev) / mix ecto.deploy (prod)mix release produces standalone tarball/binaryCopy in order:
mix.exs, mix.lockconfig/ (full config directory)lib/, test/, assets/ (Phoenix)| Stage | Image |
|---|---|
| Build | hexpm/elixir:1.18-erlang-27.3 or elixir:1.18 |
| Runtime | debian:bookworm-slim + extracted release, or elixir:1.18-slim |
FROM hexpm/elixir:1.18-erlang-27.3 AS build
WORKDIR /app
RUN mix local.hex --force && mix local.rebar --force
COPY mix.exs mix.lock ./
RUN mix deps.get --only prod && mix deps.compile
COPY config config
COPY lib lib
COPY priv priv
COPY assets assets
RUN mix assets.deploy
RUN mix compile
RUN mix release
FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y libssl3 ca-certificates && rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY --from=build /app/_build/prod/rel/my_app ./
EXPOSE 4000
CMD ["./bin/my_app", "start"]
FROM hexpm/elixir:1.18-erlang-27.3 AS build
WORKDIR /app
COPY mix.exs mix.lock ./
RUN mix deps.get --only prod && mix deps.compile
COPY config config
COPY lib lib
RUN mix compile && mix release
FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y libssl3 ca-certificates && rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY --from=build /app/_build/prod/rel/my_app ./
CMD ["./bin/my_app", "start"]
tools
Compressed catalog of all Nixopus API operations for the nixopus_api() tool
development
Deploy static file sites — Caddy/nginx serving, Staticfile config, and Dockerfile patterns. Use when deploying a static HTML site with no server-side runtime, or when index.html or a Staticfile is detected at the project root.
devops
Deploy shell script applications — interpreter detection, setup scripts, and Dockerfile patterns. Use when deploying a shell script project, or when start.sh is detected.
development
Self-healing loop for failed deployments — diagnose, fix, redeploy up to 3 attempts, then escalate or rollback. Load when a deployment fails or build errors occur.