Install Atelier

Atelier ships as a single self-installing binary. You run it on a Linux node; it sets up k3s, registry, Gitea, and the Atelier control plane in one go.

Before you install

Atelier is early-access software provided “as is”, with no warranty. It makes paid LLM API calls using your own provider credentials and costs can add up — read the full Disclaimer & risks before installing, and set spend alerts on your LLM accounts.

What you’ll need

• A Linux/amd64 host you can SSH to (laptop, homelab box, cloud VM — anything with ~4 GB free RAM works for a lab install).
• sudo on that host. The installer needs to install k3s and configure containerd.
• Outbound HTTPS — the cluster pulls all platform images (atelier-core, atelier-ui, mcp-fetch) directly from ghcr.io/atelier-project/....

Air-gapped / offline installs

Fresh installs of v0.9.8-beta and later currently require ghcr.io reach. First-class offline / air-gapped support (load all three images from local tarballs, point the catalog at an in-cluster registry) is coming as a follow-up — track progress in the relevant issue if that’s a blocker for you.

Install

Download the installer, then run it:

curl -Lo atelier-install https://tryatelier.blob.core.windows.net/tryatelier/latest/atelier-install
chmod +x atelier-install
./atelier-install

That’s the whole download — no image tarballs needed. The installer binary is stamped with its own version at build time and templates the matching GHCR tags into the manifests it applies, so a v0.9.8-beta installer brings up a cluster running v0.9.8-beta images.

To pin a specific version, swap latest for the tag (e.g. v0.9.7-beta) in the URL.

After install

Once the installer prints “Atelier is ready”, open the URL it shows (typically http://atelier.home.arpa/). The first user you create becomes the cluster admin.

Continue with:

• Using Atelier — creating your first app, build pipeline, deploy controls, and what each settings panel does.
• Tailscale access — reach your Atelier instance from outside the LAN.
• Upgrading — when a new release comes out.
• Troubleshooting — common problems and how to diagnose them.

If you get stuck, the Discord is the fastest route to help.