Create your first Koriander CMS site

Published: June 30, 2026

Here's how to make your first page in Koriander CMS.

Install Koriander CMS

Install Koriander CMS on your computer using pipx. Install pipx using the official pipx installation instructions. Open a terminal on your computer and make sure that you can run pipx. Type the following command and press the Enter key:

pipx --version

pipx version on the author's computer
pipx version on the author's computer Open in new tab (full image size 37 KiB)

On the author's computer this command prints the following:

1.8.0

pipx printing a version number like

Install Koriander CMS with pipx install koriander
Install Koriander CMS with pipx install koriander Open in new tab (full image size 43 KiB)
1.8.0 , you're ready to install Koriander CMS on your computer. Type the following command and press the Enter key:

pipx install koriander

When Koriander CMS installs, pipx install koriander prints the following:

  installed package koriander 0.8.2, installed using Python 3.13.13
  These apps are now globally available
    - koriander
done! ✨ 🌟 ✨

The version numbers printed here, 0.8.2 and 3.13.13 may be different when you install Koriander CMS.

Launch Koriander CMS

Type the following command in your terminal to launch Koriander CMS:

koriander

Koriander CMS prints a log in link that you can open in your browser
Koriander CMS prints a log in link that you can open in your browser Open in new tab (full image size 119 KiB)

When you launch Koriander CMS, it automatically opens its start page in your browser. If your browser doesn't open, copy the green address below the Log in with the following link: line.

Koriander CMS automatically opens in your browser
Koriander CMS automatically opens in your browser Open in new tab (full image size 73 KiB)

Press the blue Edit page link in the top to edit the start page.

Edit the page using the Edit page link
Edit the page using the Edit page link Open in new tab (full image size 108 KiB)

Add some content of your own. You can upload pictures by either dragging them into the editor or by pressing the image upload icon in the editor toolbar.

You can upload pictures in the page editor
You can upload pictures in the page editor Open in new tab (full image size 112 KiB)

Save your changes by pressing the save icon on the toolbar.

Save your changes by pressing the save icon
Save your changes by pressing the save icon Open in new tab (full image size 109 KiB)

Go back to the start page and see your newly created page:

After you press save, go back to the start page
After you press save, go back to the start page Open in new tab (full image size 374 KiB)

I would be thrilled to hear from you! Please share your thoughts and ideas with me via email.

Back to Index