takserver/DEPLOYMENT.md
Merith-TK ba547a2130
Some checks failed
Build Docker Image on Commit / build-and-publish (push) Failing after 3m8s
lets test and push
2025-07-04 02:34:05 +01:00

2.1 KiB

TAK Server Docker Compose Deployment Guide

Quick Start

  1. Copy the environment template:

    cp .env.template .env
    
  2. Edit the .env file to set your TAK archive path:

    nano .env
    

    Update the TAK_ARCHIVE_PATH to point to your actual TAK Server archive.

  3. Deploy the stack:

    docker-compose up -d
    
  4. Monitor the deployment:

    # Check service status
    docker-compose ps
    
    # View logs
    docker-compose logs -f takserver
    docker-compose logs -f takserver-db
    

Configuration

Required Setup

  • Set TAK_ARCHIVE_PATH in your .env file to point to your TAK Server archive
  • Ensure the archive file is accessible to Docker

Optional Configuration

  • Modify port mappings in .env if you have port conflicts
  • Adjust healthcheck settings in docker-compose.yml if needed

Management Commands

# Start the services
docker-compose up -d

# Stop the services
docker-compose down

# Restart services
docker-compose restart

# Update to latest image
docker-compose pull
docker-compose up -d

# View service logs
docker-compose logs -f [service-name]

# Access TAK Server shell
docker-compose exec takserver bash

# Access database shell
docker-compose exec takserver-db psql -U postgres

Accessing TAK Server

Once deployed, TAK Server will be available at:

Data Persistence

The following data is persisted across container restarts:

  • Database data in takserver-db-data volume
  • TAK Server logs in takserver-logs volume
  • SSL certificates in takserver-certs volume
  • Configuration files in takserver-config volume

Troubleshooting

  • Services not starting: Check that your TAK archive path is correct in .env
  • Port conflicts: Modify the port mappings in .env
  • Database connection issues: Wait for the database healthcheck to pass before the server starts
  • Certificate issues: Check the takserver-certs volume for SSL certificate files