Docs > Install and use

Detailed Installation Guide for HugoCMS

Welcome to the installation of your new HugoCMS! This step-by-step guide will lead you through the entire process, from initial setup to accessing the CMS, so you’ll be up and running in no time. Don’t worry if you’re not technically savvy – we’ve kept everything as simple as possible.

Preparations

Before we start, make sure you have access to your web server. This can be done via a web hosting control panel like cPanel, Plesk, or through an SSH connection, depending on your hosting provider.

Step 1: Download HugoCMS

Change to the public_html directory (cd public_html)

Load HugoCMS into the public directory: git clone https://github.com/hugoeditor/hugocms.git . && git checkout $(git describe --tags $(git rev-list --tags --max-count=1))

Zip Version (if Git is not installed)

Download and extract HugoCMS into the Public directory: wget https://github.com/hugoeditor/hugocms/archive/refs/tags/v3.0.125.1.zip unzip v3.0.125.1.zip

Tar Version (if neither Git nor unzip is installed)

wget https://github.com/hugoeditor/hugocms/archive/refs/tags/v3.0.125.1.zip tar xzvf v3.0.125.1.zip

Step 3: Configure the Document Directory

  1. Set document directory: Ensure that HugoCMS is set as the root directory for your main website in the web server settings.
  2. Run setup: Enter https://maindomain/edit, fill out the form (license not necessary), enter project name (e.g., maindomain)
  3. Save, proceed
  4. Create content ideally by copying, renaming, and editing existing files

Optional Multidomain

  1. Create new project: Remember the project name! (second-domain)
  2. Configure hosting for the new domain: the path is public_html/second-domain/public
  3. Access the editor: https://second-domain/edit
  4. Generate content

Possibly adjust .htaccess

See sample file: https://hugocms.com/de/doku/htaccess/

Additional Step for the Pro Version (optional):

  1. Buy a license:https://shop.hugocms.com/HugoCMS-Editor-Pro/SW10000
  2. Receive license key via email
  3. Click on Setup in the editor: Enter the license key, set minimize CSS checkbox, save - done

Congratulations! You have successfully set up your HugoCMS. If you have any questions or issues, please contact our support. Enjoy designing your website! How to install a Hugo theme with Git is described here, and if you prefer to use the HugoCMS file manager, you can read about it here."