Getting started
Getting started with Anasaki Studio
Install Anasaki Studio on your own server with Docker in a few minutes, go through the setup wizard and start building your site right away
On this page
Anasaki Studio is an open-source (MIT) website builder and CMS — manage content, design pages freely in a Figma-like designer and add features with plugins from the Plugin Store. You install it on your own server with Docker; there is no source code to download.
Want to try it first? Open the demo site with the email [email protected] and the password demo1234 — design pages, write posts and install plugins as you like. The demo resets itself every 60 minutes.
What you need#
- A server or computer that runs Docker and Docker Compose (at least 1 GB of RAM is recommended)
- The ready-made image
chichat/anasaki-studiosupports bothlinux/amd64andlinux/arm64— it runs on ordinary VPSes, Raspberry Pi 4/5 and M-series Macs - To go live on the internet: a domain and a reverse proxy that handles HTTPS (for example Caddy, Nginx or Cloudflare)
Install#
- Create a folder and download the 3 files you need:
docker-compose.yml,.env.example(saved as.env) and the scriptdocker/mysql-init/10-site-code.shmkdir anasaki-studio && cd anasaki-studio curl -fsSLO https://raw.githubusercontent.com/Kiroriya/AnasakiStudioOfficial/main/docker-compose.yml curl -fsSL https://raw.githubusercontent.com/Kiroriya/AnasakiStudioOfficial/main/.env.example -o .env mkdir -p docker/mysql-init && curl -fsSL https://raw.githubusercontent.com/Kiroriya/AnasakiStudioOfficial/main/docker/mysql-init/10-site-code.sh -o docker/mysql-init/10-site-code.sh - Open
.envand fill in the 4 required values (generate random ones withopenssl rand -hex 32oropenssl rand -hex 16)JWT_SECRET=a-long-random-value MYSQL_PASSWORD=database-password MYSQL_ROOT_PASSWORD=database-root-password CODE_DB_PASSWORD=site-code-database-password - Start it
docker compose up -d - Open
http://your-server:8090/admin/and the setup wizard appears. The public website is athttp://your-server:8090/.
docker compose up refuses to start while JWT_SECRET, MYSQL_PASSWORD, MYSQL_ROOT_PASSWORD or CODE_DB_PASSWORD is empty (there are no default passwords). Use letters and digits only, because the database passwords are part of a connection string.
Always keep the docker/mysql-init/ folder next to docker-compose.yml — on the first start its script creates the anasaki_code database and a separate MySQL user for Site Code (which cannot touch the CMS tables). See The Site Code database.
The setup wizard#
It takes less than a minute: 4 steps, then the recommended plugins.
- Language — the language of the admin (Thai, English, Japanese, Chinese or Korean). You can change it later, and every user picks their own.
- Site details — the site name and tagline. Tick Add sample content (home page, posts, menus) to start from a sample site (recommended for beginners; delete it later). Without it you get an empty home page.
- Administrator account — name, email and password (at least 8 characters). This account can do everything.
- Review — check the details, then press Install and get started.
- Recommended plugins — the official plugins the Plugin Store recommends (such as SEO, Forms and Analytics) with the permissions each one asks for. Tick the ones you want and press Install selected, or press Skip — you can install or remove plugins later on the Plugins page.
If the server cannot reach the Plugin Store, or the Store has no recommended plugins, the wizard still finishes normally. Each plugin is described in Official plugins.
To install without the wizard, set both ADMIN_EMAIL and ADMIN_PASSWORD in .env: when the database has no users yet, the system creates the administrator and the sample content for you.
Choosing a kind of site (2.5)#
The setup offers a kind of site — café, online shop, service / clinic, news blog, company, courses, portfolio or organisation — and builds a home page, menu, content types and sample items for it (all editable), with the plugins it needs ticked in the next step.
What to do next#
- Site settings → General — site name, tagline, logo, icon and time zone (Site settings)
- Pages → Design — make the home page your own (Designing pages)
- Posts & News → Write a new post — posts appear on the home page and the blog automatically (Posts, categories and menus)
- Site settings → Security — change the admin address from
/adminto something hard to guess - Site settings → Email — add SMTP for password resets, welcome emails and plugin notifications
- Set
SITE_URL(andTRUST_PROXY=truebehind a reverse proxy) before going live — see .env variables and Docker settings
Updating#
docker compose pull && docker compose up -d
All data (the database, uploaded files and plugins) lives in Docker volumes, so nothing is lost when you update. See the full steps and caveats in Updating.
