jpuck/avhost

Sunday, April 1, 2018
by jpuck
Repository
1 Watchers
0 Stars
12 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
18 Open issues
21 Versions
0 % Grown

The README.md

Apache Virtual Host Generator

, _(*1)

PHP 7 command line symfony console application to create Apache 2.4 virtual hosts for Ubuntu., _(*2)

Getting Started

This is an Apache adminstrative tool whose commands mostly require sudo. It can write configuration files to /etc/apache2/sites-available/ invoke a2ensite as well as writing SSL certificates to /etc/ssl/certs/ and keys to /etc/ssl/private/ so the best way to install it would be somewhere in root's path., _(*3)

Download the latest release, set it executable, and move it to a good path. Here's a oneline command:, _(*4)

curl -s -L https://github.com/jpuck/avhost/releases/latest | egrep -o '/jpuck/avhost/releases/download/[0-9\.]*/avhost.phar' | wget --base=http://github.com/ -i - -O avhost && chmod +x avhost && sudo mv avhost /usr/local/bin/

After installing, run without any arguments to see a list of commands:, _(*5)

avhost

Use the -h flag with any command to get help with usage:, _(*6)

avhost <command> -h

Troubleshooting

Job for apache2.service failed because the control process exited with error code. See "systemctl status apache2.service" and "journalctl -xe" for details., _(*7)

Looking at those logs are certainly helpful, but here are a couple things that might not be obvious the first time:, _(*8)

No ssl

To run an encrypted virtual host over [TLS (SSL)][21], you must have enabled [Apache Module mod_ssl][23]., _(*9)

sudo a2enmod ssl

No rewrite

The default configuration with avhost is to redirect all traffic to an encrypted connection when available. This is accomplished with Apache Module mod_rewrite., _(*10)

sudo a2enmod rewrite

This is recommended for many reasons. If necessary, this can be overridden by passing the option --no-require-ssl which makes sense in some cases, like when using a self-signed certificate that might cause trust issues. However, since you can get a free trusted certificate from Let's Encrypt, then there's no reason to be using a self-signed certificate on a public site anyway., _(*11)

403 Forbidden

If you create the document root in some random folder, then not only must that folder and files be readable to Apache, but also every directory up to root must be executable by Apache in order for it to traverse the file system., _(*12)

For example, if your site's files are in /path/to/private/web/folder, _(*13)

# up to directory, folders executable
chmod go+X /
chmod go+X /path
chmod go+X /path/to
chmod go+X /path/to/private
chmod go+X /path/to/private/web

# in directory, folders executable, files readable
chmod -R go+rX /path/to/private/web/folder

No headers

In order to add protection such as X-Content-Type-Options "nosniff" and to remove the X-Powered-By information, you must enable [Apache Module mod_headers][24]. This is also needed to allow [Cross Origin Resource Sharing][25], which is not enabled by this project - you must manually define your CORS headers if you want., _(*14)

sudo a2enmod headers

No compression

For performance reasons, most file types are compressed, but you must have enabled [Apache Module mod_deflate][26]., _(*15)

sudo a2enmod deflate

The Versions

01/04 2018

1.0.0

1.0.0.0

library avhost

jpuck/avhost

The README.md

Apache Virtual Host Generator

Getting Started

Troubleshooting

No ssl

No rewrite

403 Forbidden

No headers

No compression

The Versions

1.0.0

dev-configurable

The Requires

The Development Requires

by Jeff Puckett

dev-options

The Requires

The Development Requires

by Jeff Puckett

dev-gettersAndFluentSetters

The Requires

The Development Requires

by Jeff Puckett

dev-addSigToMeta

The Requires

The Development Requires

by Jeff Puckett

dev-signature

The Requires

The Development Requires

by Jeff Puckett

dev-renderConfWithSignature

The Requires

The Development Requires

by Jeff Puckett

dev-dev

The Requires

The Development Requires

by Jeff Puckett

dev-master

The Requires

The Development Requires

by Jeff Puckett

2.5.2

The Requires

The Development Requires

by Jeff Puckett

2.5.1

The Requires

The Development Requires

by Jeff Puckett

2.5.0

The Requires

The Development Requires

by Jeff Puckett

2.4.0

The Requires

The Development Requires

by Jeff Puckett

dev-h5bp

The Requires

The Development Requires

by Jeff Puckett

2.3.0

The Requires

The Development Requires

by Jeff Puckett

2.3.1

The Requires

The Development Requires

by Jeff Puckett

2.2.0

The Requires

The Development Requires

by Jeff Puckett

2.1.1

The Requires

The Development Requires