Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Infonote

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.

...

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

Execute this PowerShell commandscommand to download and extract the latest version:

Code Block
breakoutModewide
languagepowershell
wget iex ((New-Object System.Net.WebClient).DownloadString('https://bitbucket.org/treskon/portrait-config/downloads/portrait-3x-base-config.zip -outfile app.zip
expand-archive app.zip .
rm app.zipinstall.portrait.app/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 log in with your DockerHub Account:

...

Initial Configuration

mkdir public

If you want to use demoData:

If you want to use Demo Data
mv app/config/application-prod-demoData.yml app/config/application-prod.yml

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

...

Access Portrait

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