Kevin Douglas
57 lines
1.6 KiB
Plaintext
57 lines
1.6 KiB
Plaintext
# 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 |