100 lines
3.3 KiB
Markdown
100 lines
3.3 KiB
Markdown
# 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! 🚀 |