Sawala CloudSawala Cloud — Docs
Kontena

What is Kontena

Kontena is Sawala Cloud's headless CMS — a short introduction, when to use it, and how it differs from other CMSes.

TODO: translate to Indonesian. English source is authoritative; render it into Indonesian below.

Kontena is Sawala Cloud's headless CMS — a Content Management System with no built-in front-end. Editors define schemas (content shapes, e.g. a post with a title, body, and coverImage) and fill in entries against them. Each published entry is then readable through a public REST API from anywhere — your website, mobile app, or another service.

Because Kontena ships no theme or template, you stay in full control of how content is rendered. The dashboard is for editing; your code decides the presentation.

When to choose Kontena

  • You want non-technical editors to manage content without touching code.
  • You render content yourself — a static site, a single-page app, a mobile app, or a server — and just need a clean read API.
  • You need the same content in more than one language.
  • You want media (images, video, documents) managed alongside text, backed by Berkasna.

Core concepts

  • Schema — a content type. Its type is either single or collection.
  • Collection — a schema that holds many entries (e.g. blog posts, products).
  • Single — a schema that holds one entry per locale (e.g. a homepage, an "About" page).
  • Entry status — every entry is either draft or published. The public API only ever returns published content.
  • Public API key — a read-only token (pk_live_…) that is safe to use from a browser. See API keys and access.

Schemas live inside a project, and projects belong to an organization. See organizations and projects for how that hierarchy works.

Field types

Kontena supports 15 field types:

text, url, richtext, markdown, number, boolean, date, relation, media, blocks, component, json, select, multiselect, and repeater.

The media field type is wired directly to Berkasna, so images and documents you reference in an entry are managed and served by Sawala Cloud's media product.

Publication status

Every entry is either a draft or published. Drafts are visible in the dashboard while you work on them; only published entries are returned by the public API. This is true for any key — a secret key does not unlock drafts or a preview mode over the public surface. When you are ready, publish the entry from the dashboard and it becomes readable through the API.

Multi-language

Kontena is multi-language by design:

  • A single schema stores one entry per locale — you maintain one homepage for en and one for id, for example.
  • A collection is filtered by locale at read time using the locale query parameter, so each locale's entries are returned independently.

Continue to the first tutorial to build your first blog in 15 minutes.

Daftar Isi