Docs > Installation eines Hugo-Themes without Git

Guide to Installing a Hugo Theme Without Git

If you have installed HugoCMS, you can also install a Hugo theme without direct access to the command line or Git. Here’s how you can proceed:

Step 1: Download the Theme

  1. Choose a Theme: Visit the Hugo Themes Directory and look for a theme that meets your requirements.
  2. Download the Theme: Many themes offer download links or .zip files directly on their project page. Download the .zip file of your chosen theme to your local computer.

Step 2: Upload the File to the Server

  1. Open File Manager: Log in to your HugoCMS and activate the Admin Mode via the button labeled Admin Mode, or click twice on the button labeled Normal Mode.
  2. Navigate to the themes Directory: Within the file manager, navigate to the themes folder of your Hugo installation. This is usually located in the root directory of your working directory on your web server or web hosting.
  3. Upload the Theme File: Use the upload function of the file manager to upload the .zip file of your theme, which you have previously downloaded to your computer.

Step 3: Unpack the Theme

  1. Locate the .zip File: Find the uploaded .zip file in the file manager.
  2. Unpack the File: Right-click on the .zip file and select the option to unpack (e.g., “Extract Here” or “Unpack Here”). This will extract the theme files into a new folder within the themes directory.

Step 4: Activate the Theme in Hugo

To activate the new theme, you need to update the configuration file of your Hugo website. Since you are using file manager, you can edit the configuration file (config.toml, config.yaml, or config.json) directly in the web browser.

  1. Open Configuration File: Navigate to the configuration file of your Hugo website and open it for editing.

  2. Change Theme: Change the value of the theme setting to indicate the name of the folder of the new theme you just unpacked. Save the changes.

    Example for config.json:

    "theme": "Name-of-the-Theme",

  3. Check the Changes: To check the changes, you need to publish the website, using the button with the same label, and go to your website to ensure the new theme has been applied correctly.

Done!

You have successfully installed and activated a new Hugo theme using HugoCMS. This process allows for easy management of your website files directly through a web browser, which is especially useful if you are not familiar with Git.

If you encounter any problems during the process, also check the theme’s documentation or the official Hugo documentation for further assistance.