Getting started

You can find this documentation and more on the offcial website : http://pierre.dalbianco.free.fr/homecloud/

Getting started

First of all you will need to install Home Cloud on your server : go to the downloads page to get the latest version. Then uncompress the archive and upload the whole homecloud folder where you want to run (or if you don't know exaclty where to put it, you can just let it at the root "/" folder).

First configuration

This paragraphe will guide you throught the first steps of configuring your cloud.

• The first thing you need to do is edit the file directories.php located in the "includes" folder. The second line is : $homedir = "/home/user";
  This is the full path of the directory where you want the browser to look for. Here will be located the files and folders you will see everytime you first connect to your cloud. It can be any directory on your server. To edit it, just replace /home/user by the full path of the desired directory.
• The third line is : $limit_dir = $homedir; This indicates that the user won't be allowed to get upper the $homedir directory. No matter how many time they will hit the button Up, they won't go past it. This has been set as a security measure. If you feel like it, you can edit this line to $limit_dir ="/" if you want to be able to access to any directories on your server but beware of malicious users that may want to mess up with your server. If you are not sure what to do, you should probably not edit this line.
• Make sure that PHP has the requiered rights to read/write the appropriates files and folders. If PHP does not have the proper rights to read your files and folders, you won't be able to list and display the contents of your cloud. If PHP does not have the proper rights to write your files and folders you won't be able to rename them or to upload new ones.

Please note that Home Cloud does not come with any user restriction : any user can access it and browser throught your files. If you want to restrict the access to your cloud (which is highly recommanded) you can use a .htaccess file.
One last thing you will quickly notice : the main page is browser.php. Once installed you are free to create another index.html page that links to it or redirect the user straight to it.

Browser your cloud
Once you are connected to your cloud throught any other device you will see something similar to that:

1. Go back to the home directory $homedir
2. Go to the parent directory (won't work from the $limit_dir)
3. Current directory. Note that you can edit it and hit enter or click 4. to go to a desired folder
4. Go to the directory printed in 3.
5. Opens a promt in which you can copy/paste the url of a file. This file will be directly downloaded to your cloud in the current folder
6. Shows a form allowing you to upload files from your device to the cloud. You can click on the button that will appear and select one or several files or just drag and drop files in the appropriate box (on the right hand side of the window)
7. Create a new folder. Opens a promt in which you can write the name of this forlder
8. Click an a folder to open it / Click on a file to download it (froé the cloud to your device)
9. Unzip the file (for zip archives only)
10. Opens a prompt to rename the folder / file
11. Opens a prompt to move the folder / file to a new directory (type the full path of the new directory)
12. Delete the folder / file. In the case of a folder, this will recursively delete all the sud-directories and the files contained

Project Members:

• Pierre DAL BIANCO (admin)