Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

This how to-article will guide you through the installation of Portrait on Windows.

Running Portrait on Windows is not meant for Production.

Instructions

This how-to contains of several steps:

  1. Install Docker Desktop

  2. Install Portrait

  3. Configure the most basic setup 

Install Docker Desktop

Go to https://www.docker.com/products/docker-desktop and Download the Docker Desktop Installer.

Execute the Installer, by default this will activate the Hyper-V feature on your Windows machine.

Attention VMware users

If you are using a VMware Workstation, activating the Hyper-V feature will lead to a non functioning VMware environment.

As a workaround, install Docker Desktop inside a VMware guest windows virtual machine and activate “Enable Hypervisor Applications” in the VM settings.

You must restart the machine after installing Docker Desktop.

Docker Desktop will run a virtual environment that is called “Docker Engine”. The engine is a Linux and uses by default 2 cores, 2 GB of memory and has a max. image size of 64GB.

The first startup of Docker Desktop will take a longer, depending on your hardware.

Open the Docker Desktop Dashboard via the System-Tray.
If you see this screen, the Engine is up and running:

Install Portrait

First you need the basic configuration which sets up the container with docker-compose and contains the basic settings file. The files are available as a package and this guide will walk you through download, extraction and usage.

Prepare a folder on your computer where Portrait should be installed, for example: C:\container\portrait.

Execute this PowerShell commands:

wget https://bitbucket.org/treskon/portrait-config/downloads/portrait-3x-base-config.zip -outfile app.zip
expand-archive app.zip .
rm app.zip

You now have a docker-compose.yml and a folder app inside your Portrait location:

  • C:\container\portrait\app

  • C:\container\portrait\docker-compose.yml

Run docker-compose

Before you can run this command, you must log in with your DockerHub Account:

docker login

Execute this command from inside the folder C:\Portrait\ or $HOME/portrait

docker-compose up -d

Access Portrait

Wait a while and go to http://localhost or test the access with: curl http://localhost.

  • No labels