Documentation update

docs/post-setup.md

@@ -0,0 +1,100 @@
+# Post-Setup Next Steps
+
+Congratulations! Your AI-powered homelab is now running. Here's what to do next.
+
+## Access Your Services
+
+- **Homepage**: `https://home.yourdomain.duckdns.org`
+  - Great place to start exploring your services
+  - After configuring your services, come back and add widgets with API keys (optional)
+  - Or ask the AI to find the API keys and add the widgets
+
+- **Dockge**: `https://dockge.yourdomain.duckdns.org`
+  - Deploy & Manage the stacks & services
+  - Your primary management interface
+
+- **Authelia**: `https://auth.yourdomain.duckdns.org`
+  - Configure 2FA for enhanced security (optional)
+
+- **Traefik**: `https://traefik.yourdomain.duckdns.org`
+  - View/Edit your routing rules
+  - Tip: Let the AI manage the routing for you
+
+- **VS Code**: `https://code.yourdomain.duckdns.org`
+   - Install GitHub Copilot Chat extension
+   - Open the AI-Homelab repository
+   - Use AI assistance for:
+      - Adding new services
+      - Configuring Traefik routing
+      - Managing Docker stacks
+
+## Monitoring Services
+
+- Use Dockge to easily view live container logs
+- Configure Uptime Kuma to provide uptime tracking with dashboards
+- Check Grafana for system metrics and monitoring
+
+## Customize Your Homelab
+
+### Add Custom Services
+
+Tell the AI what service you want to install - give it a Docker-based GitHub repository or Docker Hub image. Use your imagination, the Copilot instructions are configured with best practices and a framework to add new services.
+
+### Remove Unwanted Services
+
+To remove a stack:
+```bash
+cd /opt/stacks/stack-name
+docker compose down
+cd ..
+sudo rm -rf stack-name
+```
+
+To remove the volumes/resources for the stack:
+```bash
+# Stop stack and remove everything
+cd /opt/stacks/stack-name
+docker compose down -v --remove-orphans
+
+# Remove unused Docker resources
+docker system prune -a --volumes
+```
+
+## Troubleshooting
+
+### Script Issues
+- **Permission denied**: Run with `sudo`
+- **Docker not found**: Log out/in or run `newgrp docker`
+- **Network conflicts**: Check existing networks with `docker network ls`
+
+### Service Issues
+- **Can't access services**: Check Traefik dashboard at `https://traefik.yourdomain.duckdns.org`
+- **SSL certificate errors**: Wait 2-5 minutes for wildcard certificate to be obtained from Let's Encrypt
+  - Check status: `python3 -c "import json; d=json.load(open('/opt/stacks/core/traefik/acme.json')); print(f'Certificates: {len(d[\"letsencrypt\"][\"Certificates\"])}')"`
+  - View logs: `docker exec traefik tail -50 /var/log/traefik/traefik.log | grep certificate`
+- **Authelia login fails**: Check user database configuration at `/opt/stacks/core/authelia/users_database.yml`
+- **"Not secure" warnings**: Clear browser cache or wait for DNS propagation (up to 5 minutes)
+- **Check logs**: Use Dozzle web interface at `https://dozzle.yourdomain.duckdns.org` or run `docker logs <container-name>`
+
+### Common Fixes
+```bash
+# Restart Docker
+sudo systemctl restart docker
+
+# Check service logs
+cd /opt/stacks/stack-name
+docker compose logs -f
+
+# Rebuild service
+docker compose up -d --build service-name
+```
+
+## Next Steps
+
+1. **Explore services** through Dockge
+2. **Set up backups** with Backrest (default Restic-based solution)
+3. **Set up monitoring** with Grafana/Prometheus
+4. **Add external services** via Traefik proxying
+5. **Use AI assistance** for custom configurations
+
+Happy homelabbing! 🚀