silverstripe-framework/docs/en/00_Getting_Started/index.md
Ingo Schommer ca5b1cbf61 DOCS Rewrite server requirements
* Remove overly specific PHP RNG instructions (that's just built into PHP7 through random_bytes now, which will throw if no suitable RNG is available)
 * Remove PHP 5 RNG requirements, since we don't support that PHP release any mre
 * Remove verbose explanation of PHP 5.6 support
 * Remove conflicting instructions for PHP memory limits
 * Remove version numbers from supporetd databases other than MySQL, it's up to the community modules to define that
 * Remove Oracle support (code is nine years old!)
 * Make "community supported" status clearer on databases, people can draw their own conclusions as open source users on Github
 * Remove IIS version number, I think we should just stick to "needs web.config" and not give the impression that this is actively tested
 * Remove mention of OSes for web servers, that's kind of irrelevant in today's hosting world (containers, PaaS, etc)
 * Shorten install instructions in favour of a "quickstart" and point to lessons instead
 * Remove mention of archive download option, we really shouldn't promote this - composer is the de-facto standard
 * Add generic descriptions of the hosting environment considerations without going too much into specifics
 * Remove Apache version number, we don't test on different versions, and really mostly rely on mod_rewrite working properly. Laravel does the same (doesn't claim specific Apache version support)
2019-09-03 18:38:15 +12:00

2.2 KiB

title: Getting Started introduction: SilverStripe is a web application. This means that you will need to have a webserver and database. We will take you through the setup of the server environment as well the application itself.

Server Requirements

SilverStripe requires PHP 7.1 or newer. It runs on many webservers and databases, but feels most at home running on Apache with MySQL/MariaDB.

If you are setting up your own environment, you'll need to consider a few configuration settings such as URL rewriting and protecting access to certain files. Refer to our server requirements for details.

Quickstart Installation

If you're running Apache with MySQL/MariaDB already, and know your way around webservers, follow these steps to get started. SilverStripe is installed via composer, a package management tool for PHP that lets you install and upgrade the framework and other modules. Assuming you've got this tool, run the following command to install SilverStripe:

composer create-project silverstripe/installer my-project

Within the newly created my-project folder, point your webserver at the public/ folder. Rename .env.example to .env in your project, and configure your database connection there. See environment variables for available configuration options, e.g. to configure a default CMS login via SS_DEFAULT_ADMIN_USERNAME.

Now you should be able to build your database by running this command:

vendor/bin/sake dev/build

Your website should be available on your domain now (e.g. http://localhost). The CMS login can be accessed at /admin.

Guided Installation

If you are unsure on how this all works, or prefer to follow an installer wizard, please jump on our lessons. Webserver setup is covered in Lesson 4: Setting up a local dev environment

Troubleshooting

If you run into trouble, see common-problems or check our community help options.