Upgrade Guide

Automated Updates

The docker-compose.yml file includes a commented-out Watchtower container. Watchtower automates container updates by checking for new versions of your containers at regular intervals (default: every 3600 seconds / 1 hour).

  # watchtower:
  #   image: containrrr/watchtower
  #   environment:
  #     REPO_USER: apliqocustomer
  #     REPO_PASS:
  #     WATCHTOWER_POLL_INTERVAL: 3600
  #   volumes:
  #     - /var/run/docker.sock:/var/run/docker.sock

It updates containers with the following label. Watchtower detects new container versions, pulls the updates, and restarts the containers with the latest changes.

    labels:
      - "com.centurylinklabs.watchtower.enable=true"

Enable automated updates

• Uncomment the watchtower container in docker-compose.yml

• Set the REPO_PASS environment variable to your access token (docker token)

• Start the watchtower using:

 docker compose up -d watchtower

• Verify that Watchtower is running:

docker ps

• You can check the logs using:

docker logs {container_id}

Manual Updates

For manual updates, follow these steps:

1. Make sure that you are logged in as apliqocustomer in docker

docker login -u apliqocustomer -p {your-access-token}

2. Pull latest changes for apliqo-api image

docker pull apliqo/api:latest

3. Pull latest changes for apliqo-spa image

docker pull apliqo/spa:latest

4. Restart the apliqo-api & apliqo-spa with pulled changes

docker compose up -d apliqo-api

docker compose up -d apliqo-spa

For older version of Docker:

docker-compose up -d apliqo-api

docker-compose up -d apliqo-spa

Versioning

We are using image tags for versioning model. The version alias is the same for apliqo-api and apliqo-spa

To control the version of your application, update the image tags in the docker-compose.yml file.

  ...
  
  apliqo-api:
    image: apliqo/api:{version-is-here}
    
  ...
  
  apliqo-spa:
    image: apliqo/spa:{version-is-here}
  ...

Available Versions

1. LATEST - the latest published version

2. BETA - beta version

3. ALPHA - alpha version