Quickstart

Atelier ships as a single self-installing container image. You run it locally with Docker, and the image installs and configures Drupal itself on first boot. When it finishes, you open the console and start building by chatting.

Prerequisites

Before you begin, you need:

Docker with the Compose plugin — Docker Desktop on Mac/Windows, or Docker Engine plus docker compose on Linux. Check with docker compose version.
A credential for an AI provider — an API key from Anthropic, OpenAI, or Google Gemini (a Gemini key also unlocks image generation), or the URL of a local Ollama server. You can also add these later in the in-app onboarding wizard, which lets you connect one provider or several.

Install

Run the installer

The one-line installer writes a Docker Compose stack to ~/.atelier, pulls the image, and starts it:

curl -fsSL https://atelier-cms.ink/install.sh | bash

No AI key is needed here — you connect an AI provider in the console's first-run onboarding wizard. First boot takes a minute or two while the container installs and configures itself.

Open the console

Visit http://localhost:41221/ and log in, then go to /atelier for the operator console.

Tip

Prefer to manage the stack yourself? The installer writes a compose.yaml and a .env template to ~/.atelier, so you can run it directly instead. Set HASH_SALT in .env (run openssl rand -hex 32), then run docker compose up -d — connect an AI provider in the console's onboarding wizard afterward.

The admin username is admin. If you didn't set a password, a random one is generated on first boot and saved to the persistent private volume, so you can always recover it. Run any of these from your install directory (~/.atelier):

# Show the password generated on first boot
docker compose exec app cat /opt/drupal/private/INITIAL_ADMIN_PASSWORD

# Set a new password
docker compose exec app /opt/drupal/vendor/bin/drush --root=/opt/drupal/web user:password admin 'YourNewPassword'

# Get a one-time login link (no password needed)
docker compose exec app /opt/drupal/vendor/bin/drush --root=/opt/drupal/web uli --uri=http://localhost:41221

First run

Once you're in the console, the onboarding wizard runs first if AI isn't connected yet. It walks you through two quick steps:

Connect your AI

Connect one provider or several — Anthropic, OpenAI, Google Gemini, or a local Ollama server. Paste each API key (or, for Ollama, your server URL); it's validated against the provider before anything is saved, and stored on your own server — never in code or git. You can run chat on one provider and images on another.

Connecting Google Gemini turns on image generation too: one Google AI Studio key powers both Gemini chat and Nano Banana image generation.

Choose your models

Atelier works in roles — high thinking, task, and fast for chat, plus image description and image generation. Pick a model for each from any provider you connected; the wizard suggests sensible defaults. Change any of them now, or come back anytime — see Changing providers later below.

Each studio uses the role that fits its work: the Design System and Pages studios reason with high thinking, while the everyday assistant runs on task. You never pick a model per chat — the role does it for you, so swapping one model rebinds every studio that uses it at once.

Changing providers later

To add a provider, rotate a key, or change which model a role uses, reopen the wizard from the console: click your avatar (top-right) → Set up AI providers, or visit /atelier?onboarding=1 directly. It opens pre-filled with your current providers and model choices — already-connected providers show as Connected, and finishing without changes leaves your existing setup (and your name) untouched. Only site administrators see this option.

After that, you're in the console — pick a studio and start chatting:

Open the Design System studio to set your site's identity.
Open the Pages studio to build your first page.

Tip

You can change providers or rebind a role to a different model any time — open the avatar menu (top-right) and choose Set up AI providers to revisit the wizard. Already-connected providers show as Connected, so you only fill in what's new. See Onboarding for the details.

Upgrade

To move to a newer build, re-run the installer — it pulls the newer image and recreates the app, which converges in place:

curl -fsSL https://atelier-cms.ink/install.sh | bash

The app snapshots its database, runs any pending updates, health-checks, and automatically rolls back if something fails. Your database and uploaded files live in Docker volumes and survive upgrades.

Your own settings are kept across upgrades. An update never resets your site name, your chosen AI provider, or your model choices — it only ships new features and fixes.

Manage the stack

Run these from your install directory:

docker compose stop      # stop, keep data
docker compose up -d     # start again
docker compose down      # remove containers, keep data
docker compose down -v   # remove containers AND wipe all data (fresh start)

This setup is for local evaluation. The container answers any host header and is meant for localhost. Don't expose it on a public address without setting AINCIENT_TRUSTED_HOSTS. No data leaves your machine except calls to your chosen AI provider for the AI features, using the credential you provide (and nothing at all if you run a local model server like Ollama).