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:
Install Docker Desktop
Install Portrait
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:
Sign in (resp. create a user) for Docker Hub, otherwise the download of containers will not work.
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 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
Now start the app with this command:
docker-compose up -d
Access Portrait
Wait a while and go to http://localhost or test the access with: curl http://localhost
.