Skip to content

Commit 717c0bc

Browse files
author
Jonathan Visser
committed
Move enabling of vhosts to the bottom of the documentation page
1 parent eb992fb commit 717c0bc

File tree

1 file changed

+40
-40
lines changed

1 file changed

+40
-40
lines changed

docs/hypernode-platform/nginx/hypernode-managed-vhosts.md

Lines changed: 40 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -16,46 +16,6 @@ The Hypernode Managed Vhosts (HMV) system is an easy to use, yet powerful, syste
1616

1717
The main advantage of HMV is that it separates your Nginx config into a global folder, containing configuration for all server blocks, and domain specific configs, giving you more control and reducing unexpected side-effects of domain specific configurations.
1818

19-
## Enabling Managed Vhosts
20-
21-
The Hypernode Managed Vhosts (HMV) system is currently enabled by default on all new booted Hypernodes.
22-
23-
However if you have a Hypernode created before 01-05-2020 your Hypernode may still be running in 'legacy' mode. To enable the HMV you can run the command:
24-
25-
`hypernode-systemctl settings managed_vhosts_enabled True`.
26-
27-
This will convert your current legacy config into the HMV config. It will also convert all currently active vhosts into managed vhosts.
28-
29-
Please note that while switching to HMV is very easy, there are a few things to check after switching to make sure everything works, as not every setting is automatically transferred.
30-
31-
Run `hypernode-manage-vhosts --list` to get an overview of your current configuration and use the list below to check if it's correct. Not everything will apply to your Hypernode.
32-
33-
- Make sure your domain is the default server instead of the Hypernode. You can do this by running the following command:
34-
35-
`hypernode-manage-vhosts www.example.com --default-server`
36-
37-
- Configure the vhosts to only use HTTPS. If you already have an SSL certificate configured and you don't want to use Let's Encrypt, use this command:
38-
39-
`hypernode-manage-vhosts www.example.com --https --force-https --ssl-noclobber`
40-
41-
This will make sure you won't overwrite the existing SSL certificate.
42-
43-
If you do want to configure Let's Encrypt for the vhost you can use this command:
44-
45-
`hypernode-manage-vhosts www.example.com --https --force-https`
46-
47-
- If you make use of Varnish, make sure to enable Varnish for the specific vhosts:
48-
49-
`hypernode-manage-vhosts www.example.com --varnish`
50-
51-
- Want to redirect all traffic over www? Set up your naked domains to be wwwizers, with this command:
52-
53-
`hypernode-manage-vhosts --type wwwizer [example.com](//example.com)`
54-
55-
Please make sure to also double check your custom Nginx configurations, as these might not be converted automatically.
56-
57-
You can always use `hypernode-manage-vhosts --help` to get more information on the different configurations.
58-
5919
## Managing Vhosts
6020

6121
Once the Hypernode Managed Vhosts (HMV) system is enabled, you can start defining and configuring your vhosts. On new booted Hypernodes there will be one vhosts by default: example.hypernode.io.
@@ -146,3 +106,43 @@ If you are running into issues (e.g. SSL or other configuration errors) with Hyp
146106
`hypernode-manage-vhosts --all`
147107

148108
This regenerates the HMV configuration based on what is set in `hypernode-manage-vhosts --list` and in our experience resolves most basic issues with Hypernode Managed Vhosts.
109+
110+
## Enabling Managed Vhosts
111+
112+
The Hypernode Managed Vhosts (HMV) system is currently enabled by default on all new booted Hypernodes.
113+
114+
However if you have a Hypernode created before 01-05-2020 your Hypernode may still be running in 'legacy' mode. To enable the HMV you can run the command:
115+
116+
`hypernode-systemctl settings managed_vhosts_enabled True`.
117+
118+
This will convert your current legacy config into the HMV config. It will also convert all currently active vhosts into managed vhosts.
119+
120+
Please note that while switching to HMV is very easy, there are a few things to check after switching to make sure everything works, as not every setting is automatically transferred.
121+
122+
Run `hypernode-manage-vhosts --list` to get an overview of your current configuration and use the list below to check if it's correct. Not everything will apply to your Hypernode.
123+
124+
- Make sure your domain is the default server instead of the Hypernode. You can do this by running the following command:
125+
126+
`hypernode-manage-vhosts www.example.com --default-server`
127+
128+
- Configure the vhosts to only use HTTPS. If you already have an SSL certificate configured and you don't want to use Let's Encrypt, use this command:
129+
130+
`hypernode-manage-vhosts www.example.com --https --force-https --ssl-noclobber`
131+
132+
This will make sure you won't overwrite the existing SSL certificate.
133+
134+
If you do want to configure Let's Encrypt for the vhost you can use this command:
135+
136+
`hypernode-manage-vhosts www.example.com --https --force-https`
137+
138+
- If you make use of Varnish, make sure to enable Varnish for the specific vhosts:
139+
140+
`hypernode-manage-vhosts www.example.com --varnish`
141+
142+
- Want to redirect all traffic over www? Set up your naked domains to be wwwizers, with this command:
143+
144+
`hypernode-manage-vhosts --type wwwizer [example.com](//example.com)`
145+
146+
Please make sure to also double check your custom Nginx configurations, as these might not be converted automatically.
147+
148+
You can always use `hypernode-manage-vhosts --help` to get more information on the different configurations.

0 commit comments

Comments
 (0)