silverstripe-framework/docs/en/00_Getting_Started/index.md

68 lines
2.6 KiB
Markdown
Raw Normal View History

---
title: Getting Started
2021-06-30 09:11:46 +02:00
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.
icon: rocket
---
## Server Requirements
Silverstripe requires PHP 7.1 or newer. It runs on many webservers and databases, but is most commonly served using
Apache and 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](server_requirements) for details.
2012-11-03 06:00:58 +01:00
## Quickstart Installation
2012-11-03 06:00:58 +01:00
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](https://getcomposer.org), 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:
2012-11-03 06:00:58 +01:00
```
composer create-project silverstripe/installer my-project
```
2012-11-03 06:00:58 +01:00
Within the newly created `my-project` folder, point your webserver at the `public/` folder.
Now create a `.env` file your project root (not the `public/` folder). It sets up the minimum
required [environment variables](environment_management). Replace the placeholders as required:
```
SS_DATABASE_CLASS="MySQLDatabase"
SS_DATABASE_NAME="<database>"
SS_DATABASE_SERVER="localhost"
SS_DATABASE_USERNAME="<user>"
SS_DATABASE_PASSWORD="<password>"
SS_DEFAULT_ADMIN_USERNAME="admin"
SS_DEFAULT_ADMIN_PASSWORD="password"
SS_ENVIRONMENT_TYPE="<dev|test|live>"
```
2012-11-03 06:00:58 +01:00
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`.
2012-11-03 06:00:58 +01:00
For more information on how to maintain your installation or install projects, check
out [Using Silverstripe with Composer](composer).
## Guided Installation
2012-11-03 06:00:58 +01:00
If you are unsure on how this all works, please jump on our [lessons](https://www.silverstripe.org/learn/lessons/v4/).
Webserver setup is covered in
[Lesson 4: Setting up a local dev environment](https://www.silverstripe.org/learn/lessons/v4/up-and-running-setting-up-a-local-silverstripe-dev-environment-1).
2012-11-03 06:00:58 +01:00
## Keep learning
[CHILDREN]
## Troubleshooting
If you run into trouble, see [the Tips & Tricks forum](https://forum.silverstripe.org/c/tips) or get help on
our [Slack channel](https://www.silverstripe.org/community/slack-signup/).