kdouglas011/portainer-stacks
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Updated ReadMe.

Browse Source
This commit is contained in:
Kevin Douglas
2026-04-27 15:15:28 -04:00
parent 835dd43b1c
commit a1c6d800c4
1 changed files with 27 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files
readme
+27 -29
View File
@@ -1,57 +1,55 @@
# Portainer Stacks # Portainer Stacks
My collection of Docker Compose stacks for Portainer. My personal collection of Docker Compose stacks for Portainer.
This repo is the single source of truth for all my self-hosted services. This repository is the **single source of truth** for all my self-hosted services.
## Folder Structure ## Folder Structure
portainer-stacks/ portainer-stacks/
├── gitea/ ├── gitea/
├── portainer/ ├── portainer/
├── pihole/ ├── pihole/
├── homeassistant/ ├── homeassistant/
├── homepage/ ├── homepage/
├── ... (other services) ├── ... (additional services)
└── README.md └── README.md
Each folder contains a `docker-compose.yml` (or `.yaml`) file for that service. Each service folder contains its own docker-compose.yml (or docker-compose.yaml) file.
## How to Work with This Repo ## How to Work with This Repo
### 1. Clone the Repository (First Time) 1. Clone the Repository (first time only)
On your **Mac** or any server:
git clone http://192.168.1.46:3131/kdouglas011/portainer-stacks.git ~/portainer-stacks git clone http://192.168.1.46:3131/kdouglas011/portainer-stacks.git ~/portainer-stacks
cd ~/portainer-stacks cd ~/portainer-stacks
# 1. Go to the repo folder 2. Daily Workflow (pull → edit → push)
Always start here
cd ~/portainer-stacks cd ~/portainer-stacks
# 2. Always pull the latest changes first
git pull origin main git pull origin main
3. Make your changes to any docker-compose.yml file
# 3. Make your changes to any docker-compose.yml file Stage, commit, and push
# 4. Stage, commit, and push
git add . git add .
git commit -m "Updated pihole stack - changed ports and password" git commit -m "Updated pihole stack - changed ports and password"
git push origin main git push origin main
# 5. Deploy / Update Stacks in Portainer 4. Deploy / Update the Stack in Portainer
Open Portainer → Stacks → Add stack (or edit an existing one) - Open Portainer → Stacks
Choose Repository as the build method - Click Add stack (or edit an existing one)
Fill in: - Choose Repository as the build method
Repository URL: http://192.168.1.46:3131/kdouglas011/portainer-stacks.git - Fill in the following:
Repository reference: refs/heads/main FieldValueRepository URL http://192.168.1.46:3131/kdouglas011/portainer-stacks.git
Compose path: pihole/docker-compose.yml (example — use the exact path) Repository reference refs/heads/main
Compose path pihole/docker-compose.yml (use exact relative path)
- (Optional) Enable Automatic updates
- Click Deploy the stack (or Update the stack)
(Optional) Enable Automatic updates ## Tips & Best Practices
Click Deploy the stack (or Update the stack)
# Tips & Best Practices - Always run git pull origin main before editing anything.
- Use clear, descriptive commit messages.
Always run git pull before editing anything - Test changes locally first:
Use clear commit messages docker compose up -d
Test changes locally with docker compose up -d before pushing - Never commit real passwords or secrets. Use Portainer environment variables instead (highly recommended for security).
Never commit real passwords or secrets — use Portainer’s environment variables instead - Keep stacks modular — one service per folder keeps everything clean and easy to maintain.