# Setup script for postalserver/postal on Windows (PowerShell), from https://gitmanual.com/postalserver/postal # Read it before you run it: the commands come from the repo's own README and files. # Run: powershell -ExecutionPolicy Bypass -File .\setup.ps1 $ErrorActionPreference = "Stop" function Write-Step($t) { Write-Host "`n==> $t" -ForegroundColor Cyan } # Windows ships a python that only opens the Microsoft Store; it doesn't count. function Have($c) { $cmd = Get-Command $c -ErrorAction SilentlyContinue; [bool]$cmd -and $cmd.Source -notlike '*\WindowsApps\*' } # New installs change PATH; pick it up without opening a new window. function Update-Path { $env:Path = [Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [Environment]::GetEnvironmentVariable("Path", "User") } # Stop when a program fails, like bash's set -e. Dot-sourced, so cd and venv activation carry on to the next step. function Invoke-Step([scriptblock]$Block) { $global:LASTEXITCODE = 0; . $Block; if ($LASTEXITCODE) { throw "Failed with exit code $LASTEXITCODE" } } Write-Step '1/5 Clone the repository' if (-not (Test-Path 'postal')) { Invoke-Step { git clone https://github.com/postalserver/postal.git } } Set-Location 'postal' Write-Step '2/5 Install the required runtimes' # Ruby 3.4.6 # Install Ruby+Devkit from https://rubyinstaller.org (or use WSL — recommended for Ruby) Write-Step '3/5 Start backing services' # Needs: MariaDB if (-not (Have 'docker')) { Invoke-Step { winget install Docker.DockerDesktop -e --accept-source-agreements --accept-package-agreements }; Update-Path } Invoke-Step { docker compose -f docker-compose.yml up -d } Write-Step '4/5 Install dependencies' Invoke-Step { bundle install } Write-Step '5/5 Set up the database / app' Invoke-Step { ruby bin/rails db:prepare } Write-Host 'Set up postalserver/postal.' Write-Host 'Next, from the project folder:' Write-Host ' ruby bin/dev' Write-Host ' ruby bin/rails test' Write-Host 'Manual: https://gitmanual.com/postalserver/postal'