Getting the Files

With SSH Access (Cloud Server/SSH for Shared Hosting)

There's a few options here. First, you can always use Github via the command line:

git clone git@github.com:adaptcms/AdaptCMS.git

You can also grab the latest version, at any time below:

wget https://s3.amazonaws.com/adaptcms/latest.zip && unzip latest.zip

Or if you would like to get the newest stable version:

wget https://s3.amazonaws.com/adaptcms/stable.zip && unzip latest.zip

No SSH Access (Shared Hosting)

So, assuming your PHP version is newer than 5.6.4 you can simply download one of the ZIP files below:

Stable

​https://s3.amazonaws.com/adaptcms/stable.zip​

Latest

​https://s3.amazonaws.com/adaptcms/latest.zip​

Then simply unzip the contents of the file locally. For the next step, you need an FTP client. We recommend:

Simply upload the contents of the ZIP file, which is a mix of folders and files, to your web host.

No SSH access and your PHP version aren't new enough? We highly recommend the below cloud server host. While it might be intimidating, we have an easy guide DigitalOcean.

Permissions

Permissions are one of the most important things for the install to go right.

SSH Access

Please run the following commands in the directory you've installed AdaptCMS to. This will open the permissions for the CMS to be able to write/read files, while still not allowing public users to do anything nasty to your server.

chown www-data:www-data  -R . # Let the web server be the owner
find . -type d -exec chmod 755 {} \;  # Change directory permissions
find . -type f -exec chmod 644 {} \;  # Change file permissions

Now, if you installed through Github or BitBucket, you'll want to run this command so that pull requests are still tied to the main user account on the server:

chown root:www-data  -R . # Let the web server be the owner

If your account is something different, such as ubuntu if you're on AWS, replace that with root. You should see the username in the path, but if you're unsure just run this:

whoami

No SSH Access

Through your FTP editor, please edit the permissions of the folders by right-clicking on a folder. The following folders need the permissions 755:

• app/Modules

• bootstrap/cache

• public/storage

• public/themes

• public/uploads

• storage

Secondly, please change the permissions for the following files in the root directory to 644:

• .commit_hash

• .env

• .version

Running the Installer

Let's just say your site is example.com for simplicity sake from here on out. So you've uploaded all the files and set the permissions, you're ready for the next step. Go to the below URL, replacing your website domain of course:

http://www.example.com

If all goes well, you should see an installation setup guide that will take you through the different installation steps.

If you encounter any problems, whether it's getting the CMS to install or while using it, please feel free to reach out to us:

• ​Community Forums​

• ​Slack​

• ​Twitter​

• ​GitHub Issues​

• ​Facebook​

• ​AdaptCMS.com​