https://github.com/ujstor/self-hosting-apps-home-network
Managing Docker containers through an Nginx reverse proxy and securing connections with SSL
https://github.com/ujstor/self-hosting-apps-home-network
docker docker-compose nginx nginx-docker nginx-proxy reverse-proxy ssl ssl-certificates
Last synced: 3 months ago
JSON representation
Managing Docker containers through an Nginx reverse proxy and securing connections with SSL
- Host: GitHub
- URL: https://github.com/ujstor/self-hosting-apps-home-network
- Owner: Ujstor
- Created: 2023-12-09T02:01:54.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-12-13T16:16:46.000Z (over 2 years ago)
- Last Synced: 2025-01-22T18:51:53.241Z (over 1 year ago)
- Topics: docker, docker-compose, nginx, nginx-docker, nginx-proxy, reverse-proxy, ssl, ssl-certificates
- Language: Makefile
- Homepage:
- Size: 32.2 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Self-Hosting Apps on a Home Network
If you have reasons for not purchasing and using a Virtual Private Server (VPS), such as [Hetzner](https://hetzner.cloud/?ref=Ix9xCKNxJriM) (€20 in cloud credits us if link is used), which is both affordable and reliable at just $5 a month and can be set up with a free Continuous Deployment pipeline like [Coolify](https://coolify.io/docs/), then this repository is ideal for self-hosting on your local machine It focuses on running various applications within Docker containers, managing them through an [Nginx reverse proxy](https://nginxproxymanager.com/guide/#hosting-your-home-network), and securing connections with SSL.
### Applications Hosted:
1. **Static Website:** A Go-based web application.
2. **Notes App:** A Flask application with SQLite.
3. **Go App with PostgreSQL:** A Go application utilizing a PostgreSQL database.
### Prerequisites:
- Basic understanding of Docker, Nginx, and network configurations.
- A PC with Docker installed, ready to host applications.
- Access to your home network router for port configurations.
## Initial Setup Steps
1. **Buy a DNS Domain:**
- Purchase a domain name from a registrar (e.g., GoDaddy, Namecheap).
- Configure DNS settings to point to your home network IP.
2. **Configure Router:**
- Open ports 80 and 443 to allow web traffic.
- Locate the Port Forwarding section in your router settings and add entries for these ports.
3. **Docker Setup:**
- Ensure Docker and Docker Compose are installed on your PC.
- Use the provided `docker-compose.yml` to set up your environment.
## Nginx Proxy Manager
Nginx Proxy Manager acts as the gateway to your applications. Use it to create forwarding domains, redirections, and manage SSL.
### Initial Access:
- Access the Nginx dashboard on http://localhost:81
- After the first login, change your admin details and password.
- Default login credentials
```bash
Email: admin@example.com
Password: changeme
```
### SSL Configuration:
- Utilize Let's Encrypt for free SSL or provide your custom SSL certificates.
- SSL is automatically handled for your domains configured in Nginx.
## Running the Applications
1. **Initial Run:**
- On the first run, GPG keys are generated, and the database initializes.
- A default admin user is created for Nginx Proxy Manager.
- This process may take a few minutes.
2. **Starting the Services:**
- Run `docker-compose up` to start all services.
- Ensure each service is correctly configured and running.
3. **Configuring Services:**
- Use the Nginx dashboard to point your domain to the respective Docker containers.
- Ensure proper network connectivity between Docker services.
4. **Security and Maintenance:**
- Regularly update your Docker images and Nginx configurations.
- Monitor your network for any unusual activity.
## Conclusion
This setup allows you to host various applications securely and efficiently from your home network. Always ensure your configurations are secure and up-to-date. For detailed configurations and troubleshooting, refer to application documentation.
