-
Notifications
You must be signed in to change notification settings - Fork 1.2k
Drupal Install on Ubuntu 22.04 #7338
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
DHBR2
wants to merge
48
commits into
develop
Choose a base branch
from
drupal-install-ubuntu-2204
base: develop
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from 1 commit
Commits
Show all changes
48 commits
Select commit
Hold shift + click to select a range
35be2c9
Merge pull request #7335 from nmelehan-akamai/rc-v1.387.0
nmelehan-akamai 689ddc6
Add index.md to Drupal guide folder
DianaHoober 1fbcb53
Finalized draft content for Drupal
DianaHoober bcee747
Installing Drupal on Ubuntu 22.04
DHBR2 fa0313b
Corrections to Install and Configure Drupal on Ubuntu 22-04
DHBR2 f36d08c
Corrections to metadata
DHBR2 3f509ec
Corrections to metadata authors
DHBR2 0ed50cf
Remove tip and change to note
DHBR2 b183510
Space removed
DHBR2 dfb2aed
metadata corrections
DHBR2 b211f40
metadata correction
DHBR2 19b9f1e
correction
DHBR2 9eb8694
Rearranged sectioins
DHBR2 b48734f
Clarified Composer version line - resolves prior suggestion
DHBR2 3f8eaef
Removed duplicate vendor missing content
DHBR2 0ad560a
Update docs/guides/websites/cms/drupal/how-to-install-and-configure-d…
DHBR2 16e8088
Update docs/guides/websites/cms/drupal/how-to-install-and-configure-d…
DHBR2 791b268
Update docs/guides/websites/cms/drupal/how-to-install-and-configure-d…
DHBR2 dd0c570
Apply suggestions from code review
DHBR2 1637b9a
Apply suggestions from code review
DHBR2 268573e
Slug syntax
nmelehan-akamai aa8314f
Change publish and modified dates
nmelehan-akamai f8a6fe3
Vale fixes
nmelehan-akamai 7c581d6
Update index.md
DHBR2 1ea984c
Fixed formatting problems that were originally missed
DHBR2 b8047d9
Fixed spelling problems that were missed
DHBR2 f207041
Contributor-sfe: update .vale.ini to bypass false linting errors
DHBR2 a800ad2
Resolved conflicts and spelling errors
DHBR2 07e322c
Refactored footnotes and table formatting for Hugo/Vale compatibility
DHBR2 6c4a71e
Fix .vale.ini config and restructured footnotes for Hugo compatibility
DHBR2 de616cc
Fix .vale.ini config and restructured footnotes for Hugo compatibility
DHBR2 e96e861
Fix .vale.ini config and restructured footnotes for Hugo compatibilit…
DHBR2 f85a062
Merge pull request #7342 from nmelehan-akamai/rc-v1.388.0
nmelehan-akamai b941e31
Update index.md
DHBR2 4084aaa
Add Vale vocabulary for technical terms
DHBR2 8ad0396
Fix trailing whitespace and spelling errors
DHBR2 c4f5a6a
Move vocab file to correct Linode styles location
DHBR2 a6c6362
Add placeholder to Vale ignore patterns and update vocabulary
DHBR2 91775d7
Added exts and SSLEngine to vocabulary
DHBR2 c57686d
Remove vocab/accept.txt and add terms to dictionary.txt
DHBR2 346fb62
Merge branch 'main' of https://github.com/linode/docs into drupal-ins…
DHBR2 7aacde1
Add placeholder shortcode to Vale ignore patterns
DHBR2 d538b6d
Fixed regex syntax error for placeholder
DHBR2 74eeb25
Update plaeholder pattern to handle whitespace
DHBR2 488697e
Removed backslash
DHBR2 ec5d3a9
Removed vale ini changes
DHBR2 c75b39e
Removed underscores causing Vale problems
DHBR2 613e2d5
Added formatting
DHBR2 File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -153,10 +153,10 @@ | |
|
||
### Create the Drupal Project Structure | ||
|
||
- Run the install command to generate the Drupal 11.1.8 structure. Replace "my_drupal_site" with your desired folder name. For directory layout details, see [Drupal.org's Directory Structure guide](https://www.drupal.org/docs/getting-started/understanding-drupal/directory-structure). | ||
- Run the install command to generate the Drupal 11.1.8 structure. Replace `my_drupal_site` with your desired folder name. For directory layout details, see [Drupal.org's Directory Structure guide](https://www.drupal.org/docs/getting-started/understanding-drupal/directory-structure). | ||
directory layout details, see [Drupal.org's Directory Structure guide](https://www.drupal.org/docs/getting-started/understanding-drupal/directory-structure). | ||
|
||
|
||
composer create-project drupal/recommended-project:11.1.8 my_drupal_site | ||
Check failure on line 159 in docs/guides/websites/cms/drupal/how-to-install-and-configure-drupal-on-ubuntu-22-04/index.md
|
||
|
||
-Change to your project folder (remove the angle brackets (<>) and use your actual folder name): | ||
|
||
|
@@ -218,31 +218,40 @@ | |
|
||
Before installing Drupal, follow the official guide to create a database and user: [Database Configuration](https://www.drupal.org/docs/drupal-apis/database-api/database-configuration). | ||
|
||
- Once complete, confirm access with a contributor-safe check: | ||
1. Once complete, confirm access with a contributor-safe check: | ||
|
||
```command | ||
mysql -u drupal_user -p -h localhost drupal_db | ||
``` | ||
|
||
Replace `drupaluser` and `drubaldb` with your database username and name. You should be able to enter the MariaDB shell without errors. | ||
Confirm that your database uses `utf8mb4` encoding: | ||
Replace `drupaluser` and `drubaldb` with your database username and name. You should be able to enter the MariaDB shell without errors. | ||
|
||
1. Confirm that your database uses `utf8mb4` encoding: | ||
|
||
```command | ||
SHOW CREATE DATABASE drupal_db; | ||
``` | ||
|
||
- Look for `CHARACTER SET utf8mb4`. Your credentials match what you'll enter in `settings.php`: | ||
1. Look for `CHARACTER SET utf8mb4`. Your credentials match what you'll enter in `settings.php`: | ||
|
||
$databases['default']['default'] = [ | ||
```file | ||
$databases['default']['default'] = [ | ||
|
||
'driver' => 'mysql', | ||
'database' => 'drupal_db', | ||
'username' => 'drupal_user', | ||
'password' => 'your_secure_password', | ||
'host' => 'localhost', | ||
]; | ||
'driver' => 'mysql', | ||
'database' => 'drupal_db', | ||
'username' => 'drupal_user', | ||
'password' => 'your_secure_password', | ||
'host' => 'localhost', | ||
]; | ||
``` | ||
|
||
- This configuration is located in `sites/default/settings.php`. | ||
This configuration is located in `sites/default/settings.php`. | ||
|
||
- During setup you may need to temporarily relax file permissions: | ||
1. During setup you may need to temporarily relax file permissions: | ||
|
||
```command | ||
chmod 664 sites/default/settings.php | ||
``` | ||
|
||
Common Errors and Fixes | ||
|
||
|
@@ -266,7 +275,7 @@ | |
| **Check** | **Purpose** | **Command** | **Expected Output** | **If Output Differs** | 🔗 **Further Info** | | ||
|------------------------|------------------------------------------|------------------------------------------------------------|--------------------------------------------------------|------------------------------------------------------------|---------------------| | ||
| PHP Version | Ensure PHP 8.1+ is installed | `php -v` | `PHP 8.1.2-` or higher | Upgrade PHP or switch environments | [PHP Docs](https://www.php.net/manual/en/) | | ||
| Required Extensions | Confirm required PHP modules | php -m \| grep -E 'pdo|mbstring|xml|json|ctype|tokenizer|curl|openssl|zip' | All listed extensions appear | Install missing modules via `apt`, `dnf`, or `brew` | [Drupal Requirements](https://www.drupal.org/docs/system-requirements) | | ||
| Required Extensions | Confirm required PHP modules | `php -m \| grep -E 'pdo\|mbstring\|xml\|json\|ctype\|tokenizer\|curl\|openssl\|zip'` | All listed extensions appear | Install missing modules via `apt`, `dnf`, or `brew` | [Drupal Requirements](https://www.drupal.org/docs/system-requirements) | | ||
| Composer Health Check | Validate Composer setup | `composer diagnose` | All checks return `OK` or `WARNING` (non-blocking) | Type `yes` if prompted about root; note any warnings* | [Composer Docs](https://getcomposer.org/doc/) | | ||
| Composer Version | Ensure Composer 2.x is installed | `composer --version` | `Composer version 2.x.x` | Upgrade Composer if version is < 2 | [Composer Install Guide](https://getcomposer.org/download/) | | ||
|
||
|
@@ -295,7 +304,7 @@ | |
| Validate Drush | Confirm Drush is working | `vendor/bin/drush --version` | `Drush version 11.5.1` or similar | Rerun install or check PHP/Composer compatibility**** | [Drush Troubleshooting](https://www.drush.org/latest/install/#troubleshooting) | | ||
| Optional Global Install| Make Drush available system-wide | Download `drush.phar`, then run: | ||
`chmod +x drush.phar` and `mv drush.phar /usr/local/bin/drush` | ||
`drush --version` | `Drush version 11.5.1` from global path | Recheck permissions or path if not executable | [Drush Phar Install](https://github.com/drush-ops/drush/releases) | | ||
`drush --version` | `Drush version 11.5.1` from global path | Recheck permissions or path if not executable | [Drush `.phar` Install](https://github.com/drush-ops/drush/releases) | | ||
|
||
* Confirm `composer.json` is writable and not locked by another process. | ||
** Make sure your PHP version meets Drush’s minimum requirement (PHP 8.1+ for Drush 11.x). | ||
|
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.