Skip to main content

​
Overview

Alpine-based container scripts use Alpine Linux as the base operating system, resulting in significantly smaller container sizes and reduced resource footprint. These are ideal for resource-constrained environments and when running multiple instances of the same service. Total Scripts: 31

​
Advantages of Alpine

Lightweight

Base image ~5MB vs Debian’s ~120MB

Fast Boot

Minimal services mean faster startup times

Security

Smaller attack surface with fewer packages

​
Installation

bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/ct/alpine-APPNAME.sh)"
Replace APPNAME with the application name (e.g., docker, grafana, wireguard).

​
Available Alpine Scripts

​
Networking & Security

alpine-adguard.sh - AdGuard Home DNS ad blocker
  • Network-wide ad and tracker blocking
  • DNS server with filtering capabilities
  • Parental controls and safe browsing
  • Detailed query logs and statistics
  • ~50MB vs ~200MB for Debian version
alpine-wireguard.sh - WireGuard VPN
  • Modern, fast VPN tunnel
  • Minimal configuration required
  • Low overhead and high performance
  • Perfect for site-to-site or road warrior setups
alpine-caddy.sh - Caddy web server
  • Automatic HTTPS with Let’s Encrypt
  • Simple configuration syntax
  • Built-in reverse proxy capabilities
  • HTTP/3 support out of the box
  • ~30MB container size
alpine-traefik.sh - Traefik reverse proxy
  • Dynamic configuration from Docker/Kubernetes
  • Automatic SSL certificate management
  • Load balancing and circuit breakers
  • Metrics and monitoring built-in
  • Lightweight alternative to Nginx Proxy Manager

​
Container Platforms

alpine-docker.sh - Docker container platform
  • Full Docker engine on Alpine base
  • Significantly smaller than Debian Docker LXC
  • Ideal for running containerized workloads
  • Docker Compose included
  • Perfect for microservices architecture
  • Resource-efficient for hosting multiple containers

​
Monitoring & Observability

alpine-grafana.sh - Grafana analytics platform
  • Beautiful dashboards for metrics visualization
  • Supports multiple data sources
  • Alerting and notifications
  • ~80MB vs ~250MB Debian version
alpine-prometheus.sh - Prometheus monitoring
  • Time-series database for metrics
  • Powerful query language (PromQL)
  • Service discovery capabilities
  • Integrates perfectly with Grafana
  • Lightweight for multi-node deployments
alpine-loki.sh - Loki log aggregation
  • Horizontally-scalable log aggregation
  • Like Prometheus, but for logs
  • Efficient indexing and storage
  • Grafana integration for log visualization
alpine-gatus.sh - Gatus health monitoring
  • Automated service health dashboard
  • HTTP/TCP/ICMP monitoring
  • Beautiful, responsive UI
  • Alerting via multiple channels
  • Minimal resource usage

​
Databases

alpine-mariadb.sh - MariaDB database server
  • MySQL-compatible relational database
  • Perfect for web applications
  • ~60MB vs ~180MB Debian version
  • Full SQL compliance
alpine-postgresql.sh - PostgreSQL database
  • Advanced open-source relational database
  • ACID compliant with rich feature set
  • Excellent for complex queries
  • JSON and advanced data type support
alpine-redis.sh - Redis data store
  • In-memory key-value store
  • Sub-millisecond latency
  • Pub/sub messaging
  • Perfect for caching and sessions
  • ~20MB container size
alpine-valkey.sh - Valkey key-value store
  • High-performance Redis fork
  • Drop-in Redis replacement
  • Community-driven development
  • Same API as Redis

​
Development Tools

alpine-gitea.sh - Gitea Git service
  • Lightweight self-hosted Git service
  • GitHub-like interface
  • Issue tracking and pull requests
  • CI/CD integration
  • ~40MB vs ~150MB Debian version
alpine-forgejo.sh - Forgejo Git forge
  • Community-driven Gitea fork
  • Same features as Gitea
  • Privacy-focused development
  • Lightweight and fast
alpine-node-red.sh - Node-RED flow programming
  • Visual programming for IoT
  • Drag-and-drop flow editor
  • Extensive node library
  • MQTT, HTTP, WebSocket support
  • Perfect for home automation integration

​
File Storage & Sync

alpine-nextcloud.sh - Nextcloud platform
  • Self-hosted file sync and share
  • Calendar, contacts, and more
  • Mobile apps available
  • ~120MB vs ~300MB+ Debian version
  • Office integration available
alpine-rclone.sh - Rclone cloud sync
  • Sync files to/from cloud storage
  • Supports 40+ cloud providers
  • Mount cloud storage as filesystem
  • Encryption and compression
  • Scheduled backups
alpine-syncthing.sh - Syncthing file sync
  • Continuous file synchronization
  • Peer-to-peer, no central server
  • End-to-end encryption
  • Cross-platform support
  • ~25MB container size
alpine-garage.sh - Garage object storage
  • Distributed S3-compatible storage
  • Self-hostable alternative to MinIO
  • Geo-distributed capabilities
  • Lightweight and efficient

​
Download Clients

alpine-transmission.sh - Transmission BitTorrent
  • Fast, lightweight BitTorrent client
  • Web interface included
  • Low resource usage
  • ~15MB vs ~100MB Debian version
  • Perfect for seedboxes
  • Supports scheduling and bandwidth limits

​
Media & Entertainment

alpine-bitmagnet.sh - Bitmagnet DHT indexer
  • Self-hosted BitTorrent DHT search engine
  • Discover torrents from the DHT network
  • No external indexers needed
  • Built-in web interface
alpine-zigbee2mqtt.sh - Zigbee to MQTT bridge
  • Connect Zigbee devices to MQTT
  • Works with 2000+ Zigbee devices
  • Essential for smart home setups
  • Integrates with Home Assistant
  • ~40MB vs ~120MB Debian version

​
Communication

alpine-teamspeak-server.sh - TeamSpeak voice server
  • Crystal-clear voice communication
  • Low latency for gaming
  • Advanced permission system
  • File sharing capabilities
  • ~30MB vs ~100MB+ Debian version

​
Security & Authentication

alpine-vaultwarden.sh - Vaultwarden password manager
  • Bitwarden-compatible server
  • Encrypted password vault
  • Browser extensions available
  • 2FA support
  • ~20MB vs ~100MB Debian version
  • Perfect for self-hosted password management
alpine-tinyauth.sh - TinyAuth service
  • Minimal authentication service
  • SSO capabilities
  • Extremely lightweight
  • Simple configuration

​
Utilities

alpine-rustypaste.sh - Rusty Paste server
  • Minimal file upload/pastebin service
  • Syntax highlighting for code
  • File expiration support
  • Simple and fast
  • ~10MB container size
alpine-it-tools.sh - IT Tools collection
  • Collection of handy developer tools
  • Encoders, generators, converters
  • No data leaves your server
  • Lightweight web interface
alpine-redlib.sh - Redlib Reddit frontend
  • Privacy-friendly Reddit frontend
  • No JavaScript required
  • RSS feeds for subreddits
  • Lightweight and fast
alpine-komodo.sh - Komodo server manager
  • Infrastructure management platform
  • Docker container management
  • Server monitoring
  • Deployment automation
alpine-rustdeskserver.sh - RustDesk server
  • Self-hosted remote desktop relay
  • Alternative to TeamViewer/AnyDesk
  • End-to-end encryption
  • Cross-platform support
  • ~25MB container size

​
Performance Comparison

ApplicationAlpine RAMDebian RAMAlpine SizeDebian Size
Grafana~80MB~250MB~80MB~350MB
MariaDB~60MB~180MB~60MB~250MB
Nextcloud~120MB~300MB+~150MB~500MB+
Docker~100MB~200MB~120MB~400MB
Vaultwarden~20MB~100MB~25MB~150MB
Redis~15MB~50MB~20MB~100MB

​
When to Use Alpine

Resource-Constrained

Limited RAM or storage? Alpine’s small footprint is ideal.

Multiple Instances

Running many containers? Save resources with Alpine.

Production Services

Critical services benefit from Alpine’s minimal attack surface.

Edge Deployment

IoT or edge computing? Alpine’s size is perfect.

​
When to Use Debian Instead

Consider using Debian-based scripts when:
  • Application requires specific system libraries not in Alpine
  • You need the widest software compatibility
  • The application uses glibc-specific features (Alpine uses musl)
  • You’re unfamiliar with Alpine’s package manager (apk)
  • The application has no official Alpine support

​
Alpine-Specific Notes

Alpine uses apk instead of apt:
apk update              # Update package index
apk add package-name    # Install package
apk del package-name    # Remove package
apk search keyword      # Search for packages
apk info package-name   # Package information
Alpine uses OpenRC instead of systemd:
rc-service name start   # Start service
rc-service name stop    # Stop service
rc-service name restart # Restart service
rc-update add name      # Enable on boot
rc-status               # Show service status
Alpine uses musl libc instead of glibc:
  • Smaller and more efficient
  • Some binary applications may require compatibility layers
  • Most modern applications compile fine with musl
  • Better for security-conscious deployments

​
Update Scripts

Most Alpine scripts include update utilities in /usr/local/bin/: 
update-appname  # Run application-specific update

​
Common Use Cases

Microservices

Deploy multiple lightweight services efficiently

Development

Fast-spinning test environments with minimal overhead

CI/CD

Quick container builds and deployments

Edge Computing

IoT gateways and edge nodes with limited resources

​
Migration Guide

  1. Export Data: Backup application data and configurations
  2. Deploy Alpine: Create new Alpine-based container
  3. Restore Data: Import data to new container
  4. Test Thoroughly: Verify all functionality works
  5. Update Integrations: Point dependent services to new container
  6. Remove Old Container: Clean up Debian container after verification
Note: Some applications may require configuration adjustments due to different file paths or service names.

​
See Also

Debian Scripts

Full-featured Debian-based alternatives

Container Overview

Back to container scripts overview

Build docs developers (and LLMs) love

Get started for freeTalk to us