Location: PHPKode > projects > SkyBlueCanvas Lightweight CMS > docs/install.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"  lang="en-us">
    <head>
        <title>SkyBlueCanvas Installation</title>
        <meta http-equiv="Content-Type" content="text/html;charset=UTF-8" /> 
        <style type="text/css">
            body {padding: 15px 80px;}
            pre, .callout {padding: 15px; border: 1px solid #DDD; background: #EEE; font-family: monospace, courier;}
            * {font-family: Verdana, arial, sans-serif; font-size: 12px;}
            h1 {font-size: 1.5em;}
            div.section {padding-top: 0px;}
            div.section h3 {padding: 10px; color: #FFF; background: #333;}
            div.sub-section {padding-left: 20px;}
            ol li, ul li {padding: 0px 0px 10px 0px;}
            ul li {list-style-type: none;}
            ul, ul li {padding-left: 0px; margin-left: 0px;}
        </style>
    </head>
    <body id="top">
        <h1>SkyBlueCanvas Installation</h1>
        
        <div class="callout">
			<p><strong>Important:</strong> If you are upgrading from an earlier version of 
			SkyBlueCanvas, please refer to <a href="upgrade.html">Upgrade.html</a>.
			</p>
        </div>
        
        <h2>Contents</h2>
        <div class="callout">
            <ul>
                <li><a href="#requirements">System Requirements</a></li>
                <li><a href="#ftp_install">FTP Installation</a></li>
                <li><a href="#ssh_install">SSH Installation</a></li>
                <li><a href="#trouble-shooting">Trouble Shooting</a></li>
                <li><a href="#get-help">Get Help</a></li>
            </ul>
        </div>

        
        <h2 id="requirements">System Requirements</h2>
        <ol>
			<li>
			    <strong>PHP version 4 or 5</strong> running on Linux, Unix, FreeBSD, OpenBSD or MacOS X<br />
                (Sorry, Windows servers are not supported at this time)
            </li>
            <li>
                <strong>A FTP Client</strong>
                <p>
                You can get FileZilla from Mozilla for free at 
                <a href="http://filezilla-project.org/download.php" target="_blank">http://filezilla-project.org/download.php</a>.
                </p>
            </li>
            <li>
                The <strong>Apache mod_rewrite module enabled</strong> (optional but recommended).
                <p>
                If you are unfamiliar with this module please consult with your hosting 
                company or system administrator.
                </p>
            </li>
            <li>
                <strong>PHP Posix Library enabled</strong>.
                <p>
                This library is used during the SkyBlueCanvas installation. If your installation of 
                PHP does not have it enabled, you can still install SkyBlueCanvas but you will have to 
                consult with your hosting provider to determine the correct file permissions to 
                set for the SkyBlueCanvas PHP files.
                </p>
            </li>
            <li>
                <strong>JavaScript enabled</strong> in your web browser
                <p>
                See <a href="http://www.umassd.edu/cits/help/javascript.cfm">http://www.umassd.edu/cits/help/javascript.cfm</a> 
                for instructions.
                </p>
            </li>
        </ol>
        <p><a href="#top">Top</a></p>
        
        <h2 id="ftp_install">FTP Installation</h2>
        <ol>
            <li>
                Download the SkyBlueCanvas ZIP or TAR file and extract the contents into a folder on your compter.
            </li>
            <li>
                <p>Connect to your web server using your FTP client and upload the SkyBlueCanvas code.</p>
                <p>Your hosting provider should have provided you with your FTP account address (URL), username and password. 
                Every FTP Client (software for connecting to a hosting account) is slightly different. Please consult the 
                documentation for your FTP Client software for connection instructions.
            </li>
            <li>
                <p>
                    Change the file permissions of the entire skyblue folder to 775. 
                    Apply the changes recursively to all directories and files in the skyblue folder.
                </p>
                <p>
                    SkyBlueCanvas will attempt to determine the correct file permissions.
                </p>
                <p>
                    If your installation of PHP does not have the Posix Library enabled, set your file 
                    permissions to 777 in order to complete the SkyBlueCanvas installation. After the 
                    installation has completed, change your file permissions to 775. 
                </p>
                <p>
                    Every hosting provider has their servers set up slightly differently and there 
                    is no single set of permissions that apply for every hosting environment. Your 
                    best bet is to consult with your hosting provider's FAQs (frequently asked questions), 
                    user forums, or customer support.
                </p>
            </li>
            <li>
                Rename the file /skyblue/htaccess.txt to .htaccess (dot htaccess) to enable SEF URLs
            </li>
            <li>
                Point your web browser to http://yourdomain.com/ or if you have installed SkyBlueCanvas 
                in a sub-directory of your main domain, http://yourdomain.com/sub_directory_where_skyblue_is_installed/.
            </li>
            <li>
                Follow the instructions that appear on your screen. This will be a simple form you need to fill in.
            </li>
            <li>
                When you log in to the Admin Control Panel, go to Admin > Settings > Default Info, 
                and enter the info in the form.
            </li>
        </ol>
        <p><a href="#top">Top</a></p>
        
        <h2 id="ssh_install">FTP Installation (Advanced Users)</h2>
        <ol>

			<li>
				Download the tar file and place it in the root of your new website.
			</li>
			<li>
				Unpack the tarball (tar -zxf skyblue.tar.gz)
			</li>
			<li>
				Rename the file /skyblue/htaccess.txt to .htaccess (dot htaccess) to enable SEF URLs
			</li>
			<li>
				Change the owner/group of the directory contents (chown -R apache:apache `*`)
				<p>
					The name of the owner and group of the web server process may vary based on operating system. 
					You may need to consult with your hosting provider or server administrator to determine the 
					name of the user and group of the Apache (httpd) process.
				</p>
			</li>
            <li>
                <p>
                    Change the file permissions of the entire skyblue folder to 775. 
                    Apply the changes recursively to all directories and files in the skyblue folder.
                </p>
                <p>
                    SkyBlueCanvas will attempt to determine the correct file permissions.
                </p>
                <p>
                    If your installation of PHP does not have the Posix Library enabled, set your file 
                    permissions to 777 in order to complete the SkyBlueCanvas installation. After the 
                    installation has completed, change your file permissions to 775. 
                </p>
                <p>
                    Every hosting provider has their servers set up slightly differently and there 
                    is no single set of permissions that apply for every hosting environment. Your 
                    best bet is to consult with your hosting provider's FAQs (frequently asked questions), 
                    user forums, or customer support.
                </p>
            </li>
            <li>
                Point your web browser to http://yourdomain.com/ or if you have installed SkyBlueCanvas 
                in a sub-directory of your main domain, http://yourdomain.com/sub_directory_where_skyblue_is_installed/.
            </li>
            <li>
                Follow the instructions that appear on your screen. This will be a simple form you need to fill in.
            </li>
            <li>
                When you log in to the Admin Control Panel, go to Admin > Settings > Default Info, 
                and enter the info in the form.
            </li>
        </ol>
        <p><a href="#top">Top</a></p>
        
        <h2 id="trouble-shooting">Trouble Shooting</h2>
        <p>
            If you get an error when you point your browser to the Setup Wizard, try setting the 
            permissions of the /skyblue/ directory to 777. It is not recommended that you leave 
            the permissions set to 777. The first screen of the Setup Wizard will suggest the 
            proper settings. Once you have completed the installation, you can change the file 
            permissions to the correct setting. If you continue to have trouble, check your 
            hosting provider’s documentation or contact their Support Center and ask for 
            "the correct settings for their server to allow web software to read and write files".
        </p>
        <p><a href="#top">Top</a></p>
        
        <h2 id="get-help">Get Help</h2>
        <p>
            I am always happy to help users install and use SkyBlueCanvas. However, my time is 
            very limited. Before you contact me for help, please do the following:
        </p>
        <ul>
            <li>Search the <a href="http://blog.skybluecanvas.com">SkyBlueCanvas Blog</a> for your particular issue.</li>
            <li>Search the <a href="http://forum.skybluecanvas.com">SkyBlueCanvas Forum</a> for your particular issue.</li>
            <li>Have the following information ready:
                <ul>
                     <li>PHP Version</li>
                     <li>Web Server operating system</li>
                     <li>Which browser brand (IE, FireFox, etc.) and version number you are using</li>
                     <li>A detailed explanation of what you wer trying to do when your problem occurred 
                         and what happened as a result.</li>
                     <li>Any error messages generated by SkyBlueCanvas or PHP</li>
                </ul>
            </li>
        </ul>
        <p><a href="#top">Top</a></p>
        
        <p>
            You are now ready to start adding your site’s content. You can log into the SkyBlueCanvas 
            admin control panel by going to <a href="admin.php">http://www.yourdomain.com/admin.php</a>.
        </p>
    </body>
</html>
Return current item: SkyBlueCanvas Lightweight CMS