Created a ReadMe for Instructions on management.
This commit is contained in:
@@ -0,0 +1,57 @@
|
|||||||
|
# Portainer Stacks
|
||||||
|
|
||||||
|
My collection of Docker Compose stacks for Portainer.
|
||||||
|
This repo is the single source of truth for all my self-hosted services.
|
||||||
|
|
||||||
|
## Folder Structure
|
||||||
|
portainer-stacks/
|
||||||
|
├── gitea/
|
||||||
|
├── portainer/
|
||||||
|
├── pihole/
|
||||||
|
├── homeassistant/
|
||||||
|
├── homepage/
|
||||||
|
├── ... (other services)
|
||||||
|
└── README.md
|
||||||
|
|
||||||
|
Each folder contains a `docker-compose.yml` (or `.yaml`) file for that service.
|
||||||
|
|
||||||
|
## How to Work with This Repo
|
||||||
|
|
||||||
|
### 1. Clone the Repository (First Time)
|
||||||
|
|
||||||
|
On your **Mac** or any server:
|
||||||
|
|
||||||
|
git clone http://192.168.1.46:3131/kdouglas011/portainer-stacks.git ~/portainer-stacks
|
||||||
|
cd ~/portainer-stacks
|
||||||
|
|
||||||
|
# 1. Go to the repo folder
|
||||||
|
cd ~/portainer-stacks
|
||||||
|
|
||||||
|
# 2. Always pull the latest changes first
|
||||||
|
git pull origin main
|
||||||
|
|
||||||
|
# 3. Make your changes to any docker-compose.yml file
|
||||||
|
|
||||||
|
# 4. Stage, commit, and push
|
||||||
|
git add .
|
||||||
|
git commit -m "Updated pihole stack - changed ports and password"
|
||||||
|
git push origin main
|
||||||
|
|
||||||
|
# 5. Deploy / Update Stacks in Portainer
|
||||||
|
|
||||||
|
Open Portainer → Stacks → Add stack (or edit an existing one)
|
||||||
|
Choose Repository as the build method
|
||||||
|
Fill in:
|
||||||
|
Repository URL: http://192.168.1.46:3131/kdouglas011/portainer-stacks.git
|
||||||
|
Repository reference: refs/heads/main
|
||||||
|
Compose path: pihole/docker-compose.yml (example — use the exact path)
|
||||||
|
|
||||||
|
(Optional) Enable Automatic updates
|
||||||
|
Click Deploy the stack (or Update the stack)
|
||||||
|
|
||||||
|
# Tips & Best Practices
|
||||||
|
|
||||||
|
Always run git pull before editing anything
|
||||||
|
Use clear commit messages
|
||||||
|
Test changes locally with docker compose up -d before pushing
|
||||||
|
Never commit real passwords or secrets — use Portainer’s environment variables instead
|
||||||
Reference in New Issue
Block a user