Prerequisities

• Docker Engine 25.x.x or later.
• Verify Docker Engine 25.x.x or later is installed and running.  
• Ensure the license file (newired.license) is available. 
• Confirm SSH access to the host machine with sudo privileges. 
• Check at least 60 GB of free disk space. 
• Ensure required ports are available: HTTP 8090 and HTTPS 8443.

Installation

1) Import docker image to local docker storage.

docker load < newired-portal-25.x.x.tar

docker load < newired-minio-25.x.x.tar

docker load < newired-database-25.x.x.tar

3) Edit docker-compose.yml file.

• Set public domain name env variable NEWIRED_DOMAIN (only for internal application settings)
• Set admin password
• Set SMTP config
• Next steps depend on license type.
  • If your license is based on MAC address
    • Set MAC address from file newired.license
      
      portal:
      networks:
      nw_network:
            mac_address: AA:BB:CC:DD:EE:11
      
      
  • If it's based on fingerprint
    
    • Comment out the MAC address property
      
      portal:
      networks:
          nw_network:
            # mac_address: xx:xx:xx:xx:xx:xx
      
      
    • Set SSH connection properties to environment variables. Best is to use dedicated account.
      
      environment:
        - HOST_SSH_PORT=<port>
        - HOST_SSH_USER=<user name>
        - HOST_SSH_PASSWORD=<password>
      
      

4) Run application.

docker-compose up -d

Note: It is only a self sign certificate for https (We recommend using a reverse proxy)

Update to new version

Since version 23.2, Newired’s Flyway migration process handles database upgrades automatically during container restarts, so no manual import of a dump is needed after updating. Still, it’s critical to take a full backup before upgrading.

• Verify the backup file exists and is not empty. 
• Ensure the docker-compose.yml file includes a persistent database volume: 
• volumes: - newired_db_data:/var/lib/postgresql/data 

1) Shut down application.

docker-compose down

docker load < newired-portal-25.x.x.tar

docker load < newired-minio-25.x.x.tar

docker load < newired-database-25.x.x.tar