Page Comparison

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

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.

...

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

...

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 commandsPowerShell command to download and extract the latest version:

wget iex ((New-Object System.Net.WebClient).DownloadString('https://bitbucketinstall.org/treskon/portrait-config/downloads/portrait-3x-base-config.zip -outfile app.zip
expand-archive app.zip .
rm app.zip/setup.ps1'))

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 login with your DockerHub Account:

...

Initial Configuration

mkdir public

If you want to use demoData:

Replace the following Configs in application-prod.yml

%title => Title of your Portrait Installation

%owner => Owner of your Portrait Installation

%adminLogin => Admin Username MUST be an email address

%adminPassword => Admin Password

%baseUrl => Set the URL under which Portrait will be accessible for end users (default: http://localhost)

%secret => Set a random Secret, which will be used internally for the JWT Tokens (example: 1iGGXV6LLnSKPZWxUeZGShJwx5Z6r93p)

Replace the following Configs in app/config/frontend/.env

%baseUrl => Set the URL under which Portrait will be accessible for end users (default: http://localhost)

Configure .env

Add:

PROXY_PORT=<port> =>Port which will be exposed to the host (default: 80)

CODE_SERVER_PW=<pw> => Will be used for the VS Code Dev Server

Run docker-compose

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:80/ or test the access with: curl http://localhost:80.