Repository navigation
Home
Tapio Heiskanen edited this page Oct 21, 2026
·
5 revisions
Alasin (Finnish for "anvil") is a web app for writing and publishing pages and posts on a Hugo site stored in GitHub, hosted on Cloudflare, with images in R2. It's built for a small group of people who write together and want something as easy as a hosted CMS, especially on iPhone and iPad, without leaving their own Hugo, GitHub and Cloudflare setup.
What's New: the latest features, and what each release brought.
For the person who sets up and looks after a site and its Alasin:
- Before You Start: the accounts and tools you need.
- Then one of:
- New Site: no site yet. One command creates the site repository, its buckets, the site's Worker and Alasin. About 30 minutes.
- Existing Site: a Hugo site already deployed on Cloudflare, with its images in R2. About 20 minutes.
- Day to day:
- Users and Access: who can sign in, and how to add and remove people.
- Authors: how posts record who wrote them, and showing it on the site.
- Updating to a new release.
- Housekeeping: rotating secrets, the nightly cleanup, reminders.
-
Removing a Site that
create-sitemade.
- Reference:
-
Configuration: every option of
alasin.toml. - Configuration Files: where each site's configuration lives, and several sites in one clone.
- Security: how sign-in, sessions, tokens and data are protected.
- Troubleshooting.
-
Configuration: every option of
For contributors, and for anyone testing a new version before it's released:
- Development: running Alasin on your computer, and how the code is laid out.
- Test Environment: a dev site with sample content and its own Alasin with a DEV badge, which can be reset after each test.
- Testing: automated tests, and the manual test runs.
- How changes are named, reviewed and released: CONTRIBUTING.md in the repository.
Ideas and plans are in the project's issues. Report vulnerabilities as described in SECURITY.md, not in public issues.