A self-hosted subscription management application built with Go and HTMX. Track your subscriptions, visualize spending, and get renewal reminders.

• 📊 Dashboard Overview: Real-time stats showing monthly/annual spending
• 💰 Subscription Management: Track all your subscriptions in one place
• 📈 Analytics: Visualize spending by category and track savings
• 🔔 Email Notifications: Get reminders before subscriptions renew
• 📤 Data Export: Export your data as CSV or JSON
• 🌍 Multi-Currency Support: Support for USD, EUR, GBP, JPY, RUB, SEK, PLN, and INR (with optional real-time conversion)
• 🐳 Docker Ready: Easy deployment with Docker
• 🔒 Self-Hosted: Your data stays on your server
• 📱 Mobile Responsive: Works great on all devices

• Backend: Go with Gin framework
• Database: SQLite (no external database needed!)
• Frontend: HTMX + Tailwind CSS
• Deployment: Docker & Docker Compose

SubTrackr is available as a multi-platform Docker image supporting both AMD64 and ARM64 architectures (including Apple Silicon).

Note: SubTrackr works fully out-of-the-box with no external dependencies. The Fixer.io API key is completely optional for currency conversion features.

1. Create docker-compose.yml:

version: '3.8'

services:
  subtrackr:
    image: ghcr.io/bscott/subtrackr:latest
    container_name: subtrackr
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    environment:
      - GIN_MODE=release
      - DATABASE_PATH=/app/data/subtrackr.db
      # Optional: Enable automatic currency conversion (requires Fixer.io API key)
      # - FIXER_API_KEY=your_fixer_api_key_here
    restart: unless-stopped

2. Start the container:

docker-compose up -d

3. Access SubTrackr: Open http://localhost:8080

docker run -d \
  --name subtrackr \
  -p 8080:8080 \
  -v $(pwd)/data:/app/data \
  -e GIN_MODE=release \
  ghcr.io/bscott/subtrackr:latest

# Optional: With currency conversion enabled
docker run -d \
  --name subtrackr \
  -p 8080:8080 \
  -v $(pwd)/data:/app/data \
  -e GIN_MODE=release \
  -e FIXER_API_KEY=your_fixer_api_key_here \
  ghcr.io/bscott/subtrackr:latest

1. Clone the repository:

git clone https://github.com/bscott/subtrackr.git
cd subtrackr

2. Build and run with Docker Compose:

docker-compose up -d --build

1. Stack Deployment:

   • Go to Stacks → Add Stack
   • Name: subtrackr
   • Paste the docker-compose.yml content
   • Deploy the stack

2. Environment Variables (optional):

   PORT=8080
   DATABASE_PATH=/app/data/subtrackr.db
   GIN_MODE=release
   

3. Volumes:

   • Create a volume named subtrackr-data
   • Mount to /app/data in the container

1. Create LXC Container:

   # Create container (Ubuntu 22.04)
   pct create 200 local:vztmpl/ubuntu-22.04-standard_22.04-1_amd64.tar.gz \
     --hostname subtrackr \
     --memory 512 \
     --cores 1 \
     --net0 name=eth0,bridge=vmbr0,ip=dhcp \
     --storage local-lvm \
     --rootfs local-lvm:8

2. Install Docker in LXC:

   pct start 200
   pct enter 200
   
   # Update and install Docker
   apt update && apt upgrade -y
   curl -fsSL https://get.docker.com | sh

3. Deploy SubTrackr:

   mkdir -p /opt/subtrackr
   cd /opt/subtrackr
   
   # Create docker-compose.yml
   nano docker-compose.yml
   # Paste the docker-compose content
   
   docker-compose up -d

1. Community Applications:

   • Search for "SubTrackr" in CA
   • Configure paths and ports
   • Apply

2. Manual Docker Template:

   • Repository: ghcr.io/bscott/subtrackr:latest
   • Port: 8080:8080
   • Path: /app/data → /mnt/user/appdata/subtrackr

1. Using Docker Package:

   • Open Docker package
   • Registry → Search "subtrackr"
   • Download latest image
   • Create container with port 8080 and volume mapping

2. Using Container Manager (DSM 7.2+):

   • Project → Create
   • Upload docker-compose.yml
   • Build and run

SubTrackr supports automatic currency conversion using Fixer.io exchange rates:

Without API key: (Fully functional)

• Basic multi-currency support with display symbols
• Manual currency selection per subscription
• Subscriptions displayed in their original currency
• No automatic conversion between currencies

With Fixer.io API key:

• Real-time exchange rates (cached for 24 hours)
• Automatic conversion between any supported currencies
• Display original amount + converted amount in your preferred currency

Setup:

1. Sign up for free at Fixer.io (1000 requests/month)
2. Get your API key from the dashboard
3. Add FIXER_API_KEY=your_key_here to your environment variables
4. Restart SubTrackr - currency conversion will be automatically enabled

Note: The free Fixer.io plan only allows EUR as the base currency. SubTrackr automatically handles cross-rate calculations (e.g., USD→INR goes through EUR) so all currency conversions work correctly regardless of this limitation.

Supported currencies: USD, EUR, GBP, JPY, RUB, SEK, PLN, INR

Configure SMTP settings in the web interface:

1. Navigate to Settings → Email Notifications
2. Enter your SMTP details:
   • Gmail: smtp.gmail.com:587
   • Outlook: smtp-mail.outlook.com:587
   • Custom: Your SMTP server details
3. Test connection
4. Enable renewal reminders

Important: Always mount a volume to /app/data to persist your database!

volumes:
  - ./data:/app/data  # Local directory
  # OR
  - subtrackr-data:/app/data  # Named volume

1. Reverse Proxy: Use Nginx/Traefik for HTTPS
2. Authentication: Add basic auth or OAuth2 proxy
3. Network: Don't expose port 8080 directly to internet
4. Backups: Regular backups of the data directory

server {
    server_name subtrackr.yourdomain.com;
    
    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

labels:
  - "traefik.enable=true"
  - "traefik.http.routers.subtrackr.rule=Host(`subtrackr.yourdomain.com`)"
  - "traefik.http.routers.subtrackr.entrypoints=websecure"
  - "traefik.http.routers.subtrackr.tls.certresolver=letsencrypt"

SubTrackr provides a RESTful API for external integrations. All API endpoints require authentication using an API key.

Create an API key from the Settings page in the web interface. Include the API key in your requests using one of these methods:

# Authorization header (recommended)
curl -H "Authorization: Bearer sk_your_api_key_here" https://your-domain.com/api/v1/subscriptions

# X-API-Key header
curl -H "X-API-Key: sk_your_api_key_here" https://your-domain.com/api/v1/subscriptions

curl -H "Authorization: Bearer sk_your_api_key_here" \
  https://your-domain.com/api/v1/subscriptions

curl -X POST \
  -H "Authorization: Bearer sk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Netflix",
    "cost": 15.99,
    "schedule": "Monthly",
    "status": "Active",
    "category": "Entertainment"
  }' \
  https://your-domain.com/api/v1/subscriptions

curl -X PUT \
  -H "Authorization: Bearer sk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "cost": 17.99,
    "status": "Active"
  }' \
  https://your-domain.com/api/v1/subscriptions/123

curl -H "Authorization: Bearer sk_your_api_key_here" \
  https://your-domain.com/api/v1/stats

Response:

{
  "total_count": 15,
  "active_count": 12,
  "total_cost": 245.67,
  "categories": {
    "Entertainment": 45.99,
    "Productivity": 89.00,
    "Storage": 29.99
  }
}

• Go 1.21+
• Docker (optional)

# Install dependencies
go mod download

# Run development server
go run cmd/server/main.go

# Build binary
go build -o subtrackr cmd/server/main.go

# Build for current platform
docker build -t subtrackr:latest .

# Build multi-platform
docker buildx build --platform linux/amd64,linux/arm64 \
  -t subtrackr:latest --push .

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0) - see the LICENSE file for details.

• Built with Gin web framework
• UI powered by HTMX and Tailwind CSS
• Icons from Heroicons

• Price History: SubTrackr currently tracks only the current price per subscription. If a subscription changes price over time, annual spend calculations will be based on the current price multiplied by the billing cycle, which may not reflect actual historical spending. For accurate historical tracking, consider manually updating subscription costs when prices change or keeping external records.

• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions

Made with ❤️ by me and Vibing