This repository has been archived on 2024-04-14. You can view files and clone it, but cannot push or open issues or pull requests.
help-center-docs/software/httpd/en.md

38 lines
1.5 KiB
Markdown
Raw Normal View History

2017-04-15 09:33:12 +00:00
+++
title = "httpd (Apache)"
lastmod = "2017-07-22T16:28:23+03:00"
2017-04-15 09:33:12 +00:00
+++
# httpd (Apache)
2017-04-15 09:33:12 +00:00
Solus provides httpd (otherwise referred to as Apache) web server for web developers to test locally before uploading their work.
2017-04-15 09:33:12 +00:00
## Installation
2017-04-15 09:33:12 +00:00
httpd can be installed either from the Software Center or via terminal:
``` bash
sudo eopkg install httpd
```
## Usage
2017-04-15 09:33:12 +00:00
### Configuration and DocumentRoot
Unlike most other operating systems, the httpd provided in Solus is [stateless](https://clearlinux.org/features/stateless), enabling us to provide out-of-the-box vendor configuration via `/usr/share/defaults/httpd/`, while still enabling the system administrator (*or a user with the appropriate permissions*) to override the vendor configuration via the system-wide configuration location, `/etc`.
Therefore, to make modifications to httpd's configuration, you must first create the directories `/etc/httpd/conf.d/` and create your own *.conf files, which will override the vendor-provided configuration files.
**Note:** Modification of the **vendor** configuration files may result in your changes being overwritten during the next update to httpd.
By default, httpd's DocumentRoot is set to `/var/www/`, thus files you desire to be accessible via your httpd server must be copied to that location.
### Management
Managing httpd is done via systemd, using the following commands:
2017-04-15 09:33:12 +00:00
``` bash
sudo systemctl enable httpd # Enable on startup
sudo systemctl start httpd # Start the web server
sudo systemctl stop httpd # Stop the web server
2017-04-15 09:33:12 +00:00
```