INSTALLATION HELP · 02 / 04

Install on Mac

CUP runs locally with Docker Desktop.

The complete step-by-step guide, with screenshots for each step.

INSTALLATION HELP

Using GPT or Claude?

Ask it to help you install CUP, one step at a time.

Show prompt

I want to install CUP on my Mac with Docker Desktop. Ask for the Mac model or chip (Apple silicon or Intel), macOS version, whether Docker Desktop is installed, and whether its engine is running. Guide me through downloading and extracting the CUP archive, launching start-cup.command, keeping the suggested port and local address, and finishing setup in the browser.

Official CUP guide : https://cup-studio.com/en/instal/mac/

Guide me in plain English, one step at a time, and wait for my reply before continuing. Use the CUP guide and official documentation; do not guess menus, commands or compatibility. If information is missing, say so and help me verify it.

Security: never ask me for a password, activation code, licence serial number, key or token. I will enter licence details only in the official CUP installer. Do not suggest commands that erase, reset or replace data. Explain the effect of any command that changes the system and wait for my approval before asking me to run it. Do not expose sensitive services to the Internet. Ask me to hide personal information in screenshots and error messages.

Start by asking the first question needed for this guide.

Never share your NAS password or licence code/serial number with an AI.

Docker Desktop for Mac documentation ↗Download the CUP Docker archiveZIP · Mac

Install Docker Desktop

Download the version for your Mac (Apple silicon or Intel). Open the downloaded file and move Docker to Applications. Confirm the app launch the first time.

Download Docker Desktop for Mac (Apple silicon or Intel) ↗

Download from Docker’s website · click to enlarge

Move Docker to Applications · click to enlarge

Confirm opening Docker · click to enlarge

Start Docker

Read and accept Docker’s terms if you agree. On the welcome screen, choose Skip to start without an account. Wait until Docker says the engine is running.

Docker terms of service · click to enlarge

Docker welcome screen · click to enlarge

Choose where to store data (optional)

To use an external drive, open Docker Desktop → Settings → Resources → Advanced, choose the disk image location, then apply and restart. Keep the drive connected. Do not move Docker.raw in Finder. Skip this step if internal storage is fine.

Disk image location setting · click to enlarge

Choose the external drive and restart · click to enlarge

Download and extract CUP

Download the archive, then double-click it to extract it. Open the extracted docker folder.

Extracted archive contents · click to enlarge

Start CUP

Open start-cup.command. If macOS asks for confirmation, allow it to open. Press Enter to keep port 8080, then open the local address shown in your browser.

CUP launcher and suggested local port · click to enlarge

The CUP container has started · click to enlarge

Activate and install CUP

Fill in the form with the email linked to the licence, the serial number you received and the owner account login details. Start the installation once and keep the tab open until it confirms completion.

CUP first-install form · click to enlarge

Installation in progress · click to enlarge

Installation complete — version shown as an example · click to enlarge

The version shown in the screenshot is an example. If email two-step verification is offered, configure email delivery in CUP first so you can receive the code.

Two-step verification option · click to enlarge

NEXT STEP · AFTER INSTALLATION

Make CUP reachable over the Internet

This diagram is for a self-hosted installation behind your own Internet gateway.

View the network diagram