Mirroristas/pockethost
2
0
Fork 0
mirror of https://github.com/pockethost/pockethost.git synced 2025-03-30 15:08:30 +00:00
Code Issues Packages Projects Releases Wiki Activity
pockethost/docs/local-domain-setup.md
Ben Allfree f5b9ebabea
Docker updates
2022-10-25 03:48:13 -07:00

1.2 KiB
Raw Blame History

Local Domain Setup Instructions

This document covers how to set up your local development environment to recongize wildcard domains with SSL. Developing the full Dockerized stack for PocketHost requires these steps.

1. Generate a root certificate for self-signing.

cd docker/mount/nginx/ssl
./create-ca.sh

2. Manually approve the self-signed certificate in your browser.

For FireFox OS X, do this:

  1. Open settings page.
  2. Search for "cert"
  3. Click View Certificates
  4. Move to the Authorities tab
  5. Import ca.crt

For other browsers and operating systems, follow the instructions here: https://github.com/BenMorel/dev-certificates

3. Generate a wildcard domain cert for pockethost.test

./create-certificate pockethost.test

4. Configure your machine to recognize wildcard localhost domains.

If you are on OS X, follow the dnsmasq instructions to set up your local machine for the ultimate local domain wildcard dev experience.

Remember to start dnsmasq every time:

brew services restart dnsmasq

If you don't want to use dnsmasq, follow the manual /etc/hosts setup instructions.