Hotaru Docs


Installing Directly from SVN

Here are two posts previously contributed to the forums on the subject of direct installation of Hotaru via Subversion.

via shibuya246


Ok, I think I found the answer. For those that want to install hotaru using svn directly to your apache machine, here are the instructions.

Command Line Steps

Login to your server using a command line editor like PuTTy. (Make sure you are logged in as the correct user and don't issues the "su -" command or it will change the ownership of the files you bring in from svn to the admin group. This may lead to owner/permission problems and make files inaccessible from the web.)

Type the following at your command prompt, starting from the directory where you want to install Hotaru, then check out (Subversion command "co"), or extract from the repository (Subversion command "export"), the latest "trunk" version of WordPress.

svn co

Note the "co" command after "svn". This means checkout. The other alternative is "export" for export.

svn export

Also, the trailing slash on the URL, and the dot "." at the end of the command, are important. They make sure the downloaded files from svn end up in the current directory. If you leave off the dot it would create a totally new installation directory (a "trunk"), which is not what you want if the current directory is the intended installation directory.

Root Folder Installation

If you are installing to your root folder (recommended), e.g. "public_html" instead of a subfolder, then you may need to use the "--force" command as well. This will occur if there are already files or folders in the "public_html" folder.

svn co --force


svn export --force

"checkout" v. "export" If you only want to install once and then not use svn for updating later I recommend the "export" command as it will not copy the ".svn" files across from every folder. This will be quicker.

If you want to use the svn command to keep your version of Hotaru up-to-date then the slower "co" method is required.

Final Steps

After you have completed the download, you will need to copy hotaru_settings_default.php to hotaru_settings.php and edit that file to include your database username/pwd settings. If you have not created a database for Hotaru you can do that now, then edit the files.

Once complete you can run the install.php script in your web browser

Note: this is for a new install of Hotaru not an upgrade.

Later, when you want to upgrade you can log into the command line of your server again, go to the directory you have Hotaru installed on and run the following svn update command:

svn up

This will overwrite all changed Hotaru files, but should not affect any themes modifications or other customized files in your themes folder. Note: To be safe you should always make a backup first, just in case.

I used the

svn export --force

command myself and was able to have all the files downloaded in about 5 seconds. The "co" command would take longer, maybe a few minutes at max.

Good luck

via mabujo


Well it’s time for another Hotaru post, this time I’m going to be showing you the best way to install and keep the CMS up to date.

Like many open source software projects, Hotaru maintains a subversion repository of its code base.

In Hotaru’s case, the subversion repo is located at

Now the great thing when a project runs a subversion repository is that we can download the source with only one command.

With the pace of Hotaru development being so quick at the moment, the following method will not only save you effort when installing the app for the first time, but will also make keeping your installation current painless.

This tutorial assumes you are using a linux server and have command line access and the svn subversion tool installed. Installing Hotaru with svn

I said it was a one line install right? Well I wasn’t lying, here’s all you need to do :

svn co public_html/ 

Let’s break the above command down.

’svn’ stands for subversion.

‘co’ means ‘check out’ and that is what we are doing, checking out a versioned branch of the code.

Then we have the Hotaru subversion URL with /trunk added to the end. This means we will be downloading the latest stable code. If you leave off /trunk then you would download the entire subversion repository, with probably tens of thousands of files. You don’t want to be doing this! Yes, I have done this accidentally in the past.

Finally we have ‘public_html/’ at the end of the command. This is the directory where you want to install Hotaru to. In my case I had previously changed my working directory to just above the web root, and I want to install Hotaru in the public_html folder.

Once you enter the command the files will be downloaded and you can run the install as normal from

Updating Hotaru with svn

The process for updating your installation with subversion is very similar.

Just do :

svn update public_html/

and run – that’s it!

So now that you know this, I hope I will save you the hassle of downloading the source .zip, unpacking and uploading everytime there is a Hotaru version update.

Getting StartedDesign and LayoutPlugin DevelopmentAdvanced TopicsFunction ReferenceTroubleshooting