Skip to content

Installing Basehim

B Basehim 2 min read

Installing Basehim means copying some files onto your web hosting and opening your site in a browser. It usually takes about a minute. You don't need to install anything on your own computer.

What you need first

  • Web hosting. The ordinary, inexpensive kind is fine — the sort sold as "shared hosting", usually with a control panel called cPanel. You don't need a dedicated server.
  • A database. Almost all hosting includes this. If you see "MySQL" anywhere in your hosting control panel, you have one.
  • Your hosting login. Either the control panel, or FTP details if you prefer that.

If you're not sure whether your hosting will work, it almost certainly will. Basehim was built specifically to run on modest hosting rather than requiring anything special.

Step 1: Create a database

In your hosting control panel, find MySQL Databases. Create a database, then create a user, then add that user to the database with full permissions.

Write down four things — you'll need them in a moment:

  • Database name
  • Username
  • Password
  • Host (nearly always localhost)

Step 2: Upload the files

Download the latest release, then upload it to your hosting using the control panel's File Manager or FTP.

Put the files in the folder your domain points at — usually public_html. If you're uploading a zip, upload it first and use the File Manager's Extract option; it's much faster than uploading files one by one.

Step 3: Open your site

Visit your domain in a browser. Basehim notices it hasn't been set up yet and shows you an installer. Enter the four database details from step 1, then choose:

  • Your site's name
  • An admin username and a strong password
  • Your email address, for password resets

Press install. When it finishes, you're done — your site is live.

If something goes wrong

A blank white page
Usually the database details are wrong. Check them character by character; the password is the usual culprit.
"Cannot connect to database"
Make sure you added the user to the database with full permissions — creating both isn't enough on its own.
You see a file list instead of your site
The files went into the wrong folder, or one level too deep. They should sit directly in public_html, not in a subfolder inside it.
"Permission denied" when writing
Your hosting needs to allow Basehim to write files. Folder permissions of 755 are usually right; your host's support can set this in a moment.

Keeping it up to date

Once installed, updates are handled from the admin area — you'll see a notice when one is available, and installing it is a single click. You won't need to repeat any of the above.

Next

Head to Getting started to publish your first page.

Keep building

More guides, or jump straight into the API reference.

Discussion

Leave a comment