---
title: Install PhotoStructure
url: https://photostructure.com/install/
date: 2026-04-08
keywords: installation, macOS, Windows, Linux, Docker, Node.js
---


<div class="serif">

<!-- markdownlint-disable MD033 -->

<div id="edition-chooser" class="sans">
  <p class="sans f4 tc mb3 lh-copy b">I want to run PhotoStructure on:</p>
  <div class="flex flex-wrap justify-center" style="gap: 24px;">
    <button id="choose-desktop" class="edition-card" type="button">
      <span class="edition-icon">💻</span>
      <span class="edition-title">My desktop or laptop</span>
      <span class="edition-desc">Windows, macOS, or Linux</span>
      <span id="detected-platform" class="detected-badge dn"></span>
    </button>
    <button id="choose-server" class="edition-card" type="button">
      <span class="edition-icon">🖥️</span>
      <span class="edition-title">My home server, NAS, or VPS</span>
      <span class="edition-desc">Docker or Node.js</span>
    </button>
  </div>
  <p id="beta-toggle" class="sans f7 tc mt3 mb0"><a href="/install?beta" class="link gray">Looking for beta builds?</a></p>
</div>

<div id="desktop-section">

### PhotoStructure for Desktops <a class="version dn f6 fw4" href=""></a>

<div class="dn no-stable-note">

{{% note %}}

**PhotoStructure 2026 is in beta** — no stable build is published yet. The downloads below install the latest beta.

{{% /note %}}

</div>

<div id="downloads" class="sans">

  <ul class="list pa0 ma0">
    <li class="win-x64 pb1">
      <a class="dl color-button" id="dl-win" href="" title="Download the Windows installer">
        <img src="/img/win10.svg" alt="" />
        Windows
      </a>
      <div class="details">Windows 10 or later</div>
    </li>
    <li class="mac pb1">
      <a class="dl color-button apple" id="dl-mac-arm64" href="" title="Download for macOS">
        <img src="/img/apple.svg" alt="" />
        macOS
      </a>
      <div class="details">
        Sonoma or later
        <span class="db mt1 f7"><a id="dl-mac-x64" href="" class="link">Intel Mac? Download here</a></span>
      </div>
    </li>
    <li class="linux-x64 pb1">
      <a class="dl color-button" id="dl-linux" href="#linux-installation" title="Install PhotoStructure on Linux">
        <img src="/img/tux.svg" alt="" />
        Linux
      </a>
      <div class="details">Ubuntu, Debian, Fedora, RHEL</div>
    </li>
  </ul>
</div>

<div class="platform-install" id="mac-install-step">

#### 🍎 macOS installation {#mac-installation}

1. Download and double-click `PhotoStructure.dmg`

2. Drag and drop the PhotoStructure icon onto the Applications folder.

3. Launch PhotoStructure from your Applications folder.

</div>

<div class="platform-install" id="win-install-step">

#### 🪟 Windows installation {#win-installation}

1. Download and double-click `PhotoStructure Setup.exe`

2. PhotoStructure will install and launch automatically

3. You may see a Windows Defender Firewall dialog. Click `Allow access`.

</div>

<div class="platform-install" id="linux-install-step">

#### 🐧 Linux installation {#linux-installation}

**64-bit Intel/AMD is supported.** Other CPU architectures can use
[PhotoStructure for Servers](/server/photostructure-for-servers/).

<div class="dn linux-stable-only">

##### Debian / Ubuntu

```bash
curl -fsSL https://dl.photostructure.com/apt/pubkey.gpg \
  | sudo gpg --dearmor -o /usr/share/keyrings/photostructure.gpg
echo 'deb [signed-by=/usr/share/keyrings/photostructure.gpg arch=amd64] https://dl.photostructure.com/apt stable main' \
  | sudo tee /etc/apt/sources.list.d/photostructure.list
sudo apt update && sudo apt install photostructure
```

To update: `sudo apt update && sudo apt upgrade photostructure`

##### Fedora / RHEL

```bash
sudo rpm --import https://dl.photostructure.com/apt/pubkey.gpg
sudo tee /etc/yum.repos.d/photostructure.repo <<'EOF'
[photostructure]
name=PhotoStructure
baseurl=https://dl.photostructure.com/rpm/stable/
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://dl.photostructure.com/apt/pubkey.gpg
enabled=1
EOF
sudo dnf install photostructure
```

To update: `sudo dnf upgrade photostructure`

</div>

<div class="dn linux-beta-only">

##### Debian / Ubuntu

```bash
curl -fsSL https://dl.photostructure.com/apt/pubkey.gpg \
  | sudo gpg --dearmor -o /usr/share/keyrings/photostructure.gpg
echo 'deb [signed-by=/usr/share/keyrings/photostructure.gpg arch=amd64] https://dl.photostructure.com/apt beta main' \
  | sudo tee /etc/apt/sources.list.d/photostructure.list
sudo apt update && sudo apt install photostructure
```

To update: `sudo apt update && sudo apt upgrade photostructure`

##### Fedora / RHEL

```bash
sudo rpm --import https://dl.photostructure.com/apt/pubkey.gpg
sudo tee /etc/yum.repos.d/photostructure.repo <<'EOF'
[photostructure]
name=PhotoStructure
baseurl=https://dl.photostructure.com/rpm/beta/
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://dl.photostructure.com/apt/pubkey.gpg
enabled=1
EOF
sudo dnf install photostructure
```

To update: `sudo dnf upgrade photostructure`

</div>

</div>

</div>

<div id="server-section">

### PhotoStructure for Servers <a class="version dn f6 fw4" href=""></a>

<div id="server-downloads" class="sans">
  <ul class="list pa0 ma0">
    <li class="pb1">
      <a class="dl color-button" href="/server/docker-compose-wizard/">
        <img src="/img/docker.svg" alt="" />
        Docker
      </a>
      <div class="details">Recommended for most users</div>
    </li>
    <li class="pb1">
      <a class="dl color-button" href="/server/photostructure-for-node/">
        <img src="/img/nodejs.svg" alt="" />
        Node.js
      </a>
      <div class="details">Direct process control</div>
    </li>
  </ul>
</div>

- Need help choosing? See the [full comparison](/server/photostructure-for-servers/).

</div>

<p id="show-all-platforms" class="sans tc mt4 mb4"><a href="#" class="link gray">Show all installation instructions</a></p>

## 📖 Release notes

[PhotoStructure's release notes](/tags/release-notes) contain detailed information about every version.

## 📣 Stay in the loop

Make sure you create a [PhotoStructure Forum](https://forum.photostructure.com) account!

- It's free

- Subscribe to just the PhotoStructure updates that you care about

- You get 4 votes for [feature requests](https://forum.photostructure.com/c/feature-requests/7/l/latest?order=votes)

## 🙋 Questions? 🌹 Feature requests? 🐞 Found a bug?

- Check out the [**PhotoStructure user guide**](/getting-started/user-guide/)

- Visit the [**PhotoStructure forum**](https://forum.photostructure.com)

- Hop into our [Discord chat](/go/discord)

</div>

