Smithy —> Use Me —> Get Started —> How to Setup

First, ask for, read and agree to the

  • Terms
  • Spirit
  • Notices

In this page, we will learn to install and get localhost running (laptop / desktop / mobile)

1. Setup Folder & Programs

  1. Create Folder: D:\JoyfulEarth\ and download these installer files to ./Setups
  2. Install Git, TortoiseGit, Apache 1 and VSCode.
  3. Additionally, BeyComp or PSPad may come in handy.
  4. For uploading (delta only) to FTP, I've been using this which I wrote in 2007.

Install and Configure Server

  1. Install Xampp (Windows + Apache + PHP) to D:\JoyfulEarth\xampp - MySql not needed for JoyfulEarth at all.
  2. Run "xampp-control.exe" as admin and change the httpd.conf file
  3. Change the DocumentRoot from D:\JoyfulEarth\xampp\htdocs to D:\JoyfulEarth\www\public_html
  4. Tick the checkbox to allow Apache to be installed as a service. Also click run (row should hae a green lael saying running on port 80).
  5. Visit localhost in the browser - it should show the amadeus9 site content but broken (see #3 - theme assets setup below).

In 2024, we had v6.5.x.

3. Extract Theme Assets

  1. Navigate to D:\JoyfulEarth\www\public_html\spring\themes\canvas\
  2. Run install-theme.bat - do this everytime the theme assets are changed, renaming the old assets folder (in case it has pending changes etc).
  3. Visit localhost again, it should be working (network tab shows all assets loaded).
  4. Click the button 'Enter Core v8 Site` - you should see the documentation.

Name About Tags Size
How to SetupNo About Set #No Tags Set1.93 KB
On MobileNo About Set #No Tags Set1.74 KB