Content Management that can withstand the plundering hoards

Getting started as a site owner

Viking CMS is the private application where you edit a website. Visitors use a separate public address. Saving in the CMS changes your editable copy, called a draft. Publishing makes the saved site available at the public address. You need a browser and a sign-in account; installation is your administrator's task.

Before signing in

Ask your administrator for your CMS address, public website address, sign-in account and permission to publish. Example addresses in these guides use https://cms.example.net and https://example.com; use the addresses you were given. A new site has no public homepage until someone creates / and publishes.

Sign in

  1. Open the CMS address. Viking redirects you to your organisation's sign-in service.
  2. Enter your credentials there and complete any second-factor or consent step.
  3. After returning to Viking, check the identity displayed at the top of the screen. If access is denied, ask your administrator to check your assigned roles.

The sign-in service is also called the identity provider, or IdP. Viking does not provide a separate local username/password registration screen.

Create your homepage

  1. Choose New and select Markdown, the default format.
  2. Enter a title, such as Welcome, and set the URL path to /.
  3. Write a heading and paragraph in Visual mode. Source shows the Markdown text behind the formatting; either mode edits the same page.
  4. Choose Preview to inspect the rendered page. Check desktop, tablet and mobile widths. Preview is private and does not publish.
  5. Choose Save draft and wait for success before leaving the page.

You can instead choose Visual page (GrapesJS) for drag-and-drop layouts, Raw downloadable object for a downloadable file with a description, or an installed renderer's format for other source text. See editing pages and downloads and packages before choosing those formats.

Add a second page and design

Create an About page at /about. Select In the menu if it should appear in the site's navigation. A theme needs a Navigation binding to display that menu. Open Themes, preview a bundled theme and choose Use theme for site. See navigation and themes for ordering, submenus and custom designs. Open Settings to set the site's title, description and favicon from uploaded images. Save settings and publish to apply those choices to the live site.

Publish and verify

  1. Save any theme/settings changes in their own workspace.
  2. Select Publish or Publish site and wait for a release number and success. Viking saves changes to the currently open page first, then publishes all saved pages, settings, theme and assets together.
  3. Open the public address in a separate browser tab. Visit / and /about/, follow menu links and check images.

A release is a complete generated copy of the site, identified by a number such as 000001. Publishing switches the active copy only after preparing it. The public server can take about one second to detect a new copy with its default settings; browser or proxy caching can add delay.

Every saved page is included in the next publication. Hiding a page from the menu does not make it private. See publishing and rollback before publishing sensitive content.

Keep work safe and end your session

Save explicitly; do not rely on a browser tab as a backup. If sign-in expires, keep the editing tab open. Carry on working lets you keep editing locally; saving/publishing stays blocked until login is repaired. Log in again preserves a per-tab draft checkpoint and signs in in the same window. Use the same account and do not reload the tab while it contains unsaved work. Use Log out when finished; the sign-in service may also end its session when it supports provider logout.

Continue with the site owner index for individual tasks and problems.