Docs > Install and use

Detailed Installation Guide for HugoCMS

Welcome to the installation of your new HugoCMS! This step-by-step guide will take 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 begin, 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 the HugoCMS Tarball

  1. Access the Download Link: Visit the download page where HugoCMS is linked. A tarball is an archive file that bundles multiple files and directories into a single file, often compressed to save space.
  2. Download: Click on the link to download the tarball. Save the file to a location where you can easily access it, such as your desktop.

Tip: Use the wget command to copy the tarball directly to the server.

Step 2: Unpack the Tarball in the Working Directory

  1. Access to the Web Server: Log in to your web hosting control panel or connect via SSH to your server.
  2. Find the Working Directory: The working directory is where your website files are stored. This is usually a folder named public_html, www, or simply public.
  3. Unpack the Tarball:
    • If you have access via a control panel, use the file manager to upload the downloaded tarball file. Then use the unpacking function available in the file manager to extract the files to the desired directory.
    • For SSH access: Upload the tarball via SFTP and use the command tar -xzf filename.tar.gz in the terminal to unpack it in the working directory.

Step 3: Configure the Document Directory

  1. Set the Document Directory: Ensure that the public directory unpacked from the tarball is set as the root directory (Root Directory) for your website in the web server settings. This can be done through your hosting’s control panel or by adjusting the server configuration file if you have direct access.

Additional Step for the Pro Version:

  1. Set Up License Files: After purchasing the Pro version, you will receive license files via email. These files must be copied to the hugocms directory on your web server to activate all Pro features.
    • Access Your Email Account: Open the email containing the license files that you received after purchasing.
    • Download the License Files: Download the license files from the email to your computer.
    • Upload the Files to the Server:
      • If you have access via a control panel, use the file manager to upload the license files to the hugocms directory on your server.
      • For SSH access: Use SFTP to transfer the files and copy them to the appropriate directory.

After successfully placing the license files, the Pro features of your HugoCMS are activated and ready to use.

Step 4: Access the CMS via Your Domain

  1. Open a Web Browser: Enter the URL of your website followed by /edit in the address bar (for example, http://mydomain.com/edit).
  2. Initial Setup: On your first visit, you will be prompted to create a password and make some basic settings for the CMS. Follow the on-screen instructions to complete this setup.

Step 5: Getting Started with Your HugoCMS

After you have set the password and completed the initial setup, you are ready to explore and use your new CMS. Start by creating new content, editing pages, and enjoying full control over your website.


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