Installing Sector

Installing Sector is as easy as installing Drupal. In this guide, we explain a couple of methods for creating a Sector site.

The two approaches we recommend are:

• Create a local Sector site for development with DDEV
• Create a manual Sector site on a remote server

Create a local Sector site for development with DDEV

Composer has become the standard tool for installing Drupal 9 sites and is the only method supported by Sector maintainers. We recommend using Prestissimo for faster installations with Composer.

Steps to create a local Sector site with DDEV

1. Install a Sector 10 site by running Composer
2. Start your project
3. Change the .ddev/config.yaml file
4. Select your language and complete installation wizard

Step 1 - Install a Sector 10 site by running Composer

composer create-project drupal/sector_project_template {project-name}

cd {project-name}

ddev config (this will start a config wizard)

You can keep the default values in this ddev config step - feel free to change the project name, but leave the docroot as 'web' and the project type as 'drupal9'.

Step 2 - Start your project

ddev start

By default, DDEV uses common ports, so you'll likely get the following error:

Step 3 - Change the .ddev/config.yaml file

Open the .ddev/config.yaml file, then change the ports listed in router_http_port and router_https_port.

Run ddev start again.

Installing Sector with DDEV

Step 4 - Select your language and complete installation wizard

Once the project has started, DDEV will give you a link - visit this link and select your language.

Sector will begin installing automatically, and after you've completed the installation wizard you will have a fresh Sector site.

Create a manual Sector site on a remote server

You can use this method to set up the production version of your site, or a version to share with others. Since this method doesn't use a tool to automate the installation (like DDEV in the previous method), everything needs to be done manually.

Steps to create a manual Sector site on a remote server

1. Create the database and database user
2. Create a host file
3. Enable the site and restart the web server
4. Visit the site and complete installation wizard

Step 1 - Create the database and database user

For guidance, see Drupal's guide for creating a database using many of the popular database engines.

Step 2 - Create a host file

You'll need to create a host file on your server which points at the site directory. This is very specific to the web server you're running.

Below, you can see an example host file for Apache 2 web servers (slightly modified from the example on Drupal's multisite documentation).

Step 3 - Enable the site and restart the web server

Now that you've created the host file, enable the site and restart the web server.

Again, this is specific to your environment - for example, for Apache 2 you can run sudo a2ensite {vhost} && sudo service apache2 reload

Step 4 - Visit the site and complete installation wizard

Visit the site to finish the setup - select your language, and on the 'Set up database' screen, enter the database details you created earlier.

Database configuration for your Sector site.

Sector will begin installing automatically, and after you've completed the installation wizard you will have a fresh Sector site.