Scrap & Sparks

Install the game

You do four things; the start file does the rest. About an hour the first time, mostly waiting for downloads.

Windows 10 or 11

  1. Turn on WSL

    5 minutes, then a restart

    WSL lets Windows run Linux programs. Docker needs it.

    1. Right-click the Start button and choose Terminal (Admin) (on Windows 10: Windows PowerShell (Admin)). Click Yes when Windows asks.
    2. Type wsl --install and press Enter.
    3. When it is done, restart your computer.
    Something went wrong?
    It says WSL is already installed
    Good: type wsl --update, press Enter, and go to the next step.
    It talks about virtualization
    Virtualization is switched off in your computer's settings (BIOS or UEFI). Search the web for your computer's brand and "enable virtualization", turn it on, then start this step again.
    Nothing happens, or an error code
    Check that Windows is up to date (Settings › Windows Update), restart, then try again. Microsoft's guide: Install WSL.
  2. Install Docker Desktop

    10 minutes
    1. Open Docker's install page for Windows and download Docker Desktop for Windows.
    2. Open the file you downloaded. Keep Use WSL 2 instead of Hyper-V ticked, follow the steps, then click Close.
    3. Open Docker Desktop from the Start menu and click Accept on its agreement. You do not need a Docker account.
    4. Wait until the bottom of its window says Engine running.
    Something went wrong?
    Docker says WSL needs an update
    Open Terminal (Admin) again, type wsl --update, press Enter, then open Docker Desktop again.
    It stays on "Starting" for a long time
    Restart your computer and open Docker Desktop again. The first start can take a few minutes.
    Docker asks me to sign in
    Signing in is not needed for this game; you can skip it.
  3. Download the game

    1 minute

    Download the game (zip)

    1. Right-click the zip file you downloaded and choose Extract All.
    2. Pick a place you will find again, for example your Documents folder.

    The folder holds a few small files. n8n and the game come later, through Docker.

    Something went wrong?
    I opened the zip, but the next step does not work
    Windows shows what is inside a zip without unpacking it. Use Extract All first, then open the new folder.
  4. Start the game

    10 to 30 minutes the first time, then under a minute
    1. In the game's folder, double-click start.bat.
    2. If Windows warns about a file from the internet, choose More info, then Run anyway (or Run).
    3. A black window shows what happens. It starts Docker Desktop if needed, then downloads n8n and the game (about 4 GB) the first time. Let it work.
    4. The game opens in your browser at http://localhost:8765.
    Something went wrong?
    "Docker Desktop is not installed yet"
    Go back to step 2, then double-click start.bat again.
    "Docker Desktop did not start"
    Open Docker Desktop yourself, wait for Engine running, then double-click start.bat again.
    "another program already uses port 5678, 8765 or 5688"
    Close the program that uses it (often another n8n), or restart your computer, then try again.
    "The game is taking long to start"
    Wait a minute, then open http://localhost:8765 in your browser yourself.
  5. Play

    5 minutes for Level 0

    The game opens on Level 0. Madame Ferrous takes you from there: you create your n8n account (it stays on your computer) and a key that lets the game check your work.

    To stop the game, double-click stop.bat. Your progress and your n8n stay saved; start.bat brings them back.

Mac

  1. Install Docker Desktop

    10 minutes
    1. Check your Mac's chip: Apple menu › About This Mac. It says Chip (Apple silicon, for example M1) or Processor (Intel).
    2. Open Docker's install page for Mac and download the version for your chip.
    3. Open Docker.dmg and drag Docker into Applications.
    4. Open Docker from Applications and click Accept on its agreement. You do not need a Docker account.
    Something went wrong?
    Docker says my macOS is too old
    Docker Desktop supports the current macOS and the two before it. Update macOS (System Settings › General › Software Update) if you can.
    Docker asks me to sign in
    Signing in is not needed for this game; you can skip it.
  2. Download the game

    1 minute

    Download the game (zip)

    Double-click the zip file to unpack it, then move the new folder somewhere you will find again, for example Documents.

  3. Start the game

    10 to 30 minutes the first time, then under a minute
    1. Open Terminal (press Cmd + Space, type Terminal, press Enter).
    2. Type sh and a space, drag the file start.sh from the game's folder into the Terminal window, then press Enter.
    3. Terminal shows what happens. It starts Docker Desktop if needed, then downloads n8n and the game (about 4 GB) the first time. Let it work.
    4. The game opens in your browser at http://localhost:8765.
    Something went wrong?
    "Docker Desktop did not start"
    Open Docker yourself from Applications, wait until it is running, then run sh start.sh again.
    "another program already uses port 5678, 8765 or 5688"
    Close the program that uses it (often another n8n), then try again.
    "The game is taking long to start"
    Wait a minute, then open http://localhost:8765 in your browser yourself.
  4. Play

    5 minutes for Level 0

    The game opens on Level 0. Madame Ferrous takes you from there: you create your n8n account (it stays on your computer) and a key that lets the game check your work.

    To stop the game, run stop.sh the same way (sh, a space, drag the file, Enter). Your progress and your n8n stay saved.

Linux

  1. Install Docker Engine and Compose

    10 minutes
    1. Follow Docker's guide for your distribution (Ubuntu, Debian, Fedora and others). It installs Docker Engine and its Compose plugin.
    2. Let your user run Docker without sudo: Linux post-installation steps. Log out and back in afterwards.
    3. Check it works: docker compose version prints a version.
    Something went wrong?
    "permission denied" when running docker
    Your user is not in the docker group yet, or you have not logged out and back in. See the post-installation steps above.
    "docker: 'compose' is not a docker command"
    The Compose plugin is missing: install the docker-compose-plugin package from Docker's guide.
  2. Download the game

    1 minute

    Download the game (zip)

    Unpack it where you keep your things, for example with your file manager or unzip.

  3. Start the game

    10 to 30 minutes the first time, then under a minute
    1. Open a terminal in the game's folder and run sh start.sh.
    2. It downloads n8n and the game (about 4 GB) the first time. Let it work.
    3. The game opens in your browser at http://localhost:8765.
    Something went wrong?
    "Docker is not running"
    Start it, for example with sudo systemctl start docker, then run sh start.sh again.
    "another program already uses port 5678, 8765 or 5688"
    Stop the program that uses it (often another n8n), then try again.
    The browser does not open
    Open http://localhost:8765 yourself.
  4. Play

    5 minutes for Level 0

    The game opens on Level 0. Madame Ferrous takes you from there: you create your n8n account (it stays on your computer) and a key that lets the game check your work.

    To stop the game: sh stop.sh. Your progress and your n8n stay saved.

Questions

Is Docker free?
Docker Desktop is free for personal use, education, and businesses with fewer than 250 employees and less than $10 million in yearly revenue. Larger companies need a paid Docker subscription. See Docker's pricing.
How much space does it take?
About 4 GB to download once: n8n, its helper for the Code node, and the game. Docker itself is extra.
Does my n8n go on the internet?
No. n8n runs on your computer and only your computer can open it. The game only reads workflows tagged scrap-and-sparks. What the game sends, if you allow it, is on the privacy page.
How do I remove everything?
Stop the game, then in the game's folder run docker compose down -v. This deletes the game's n8n and its workflows for good. Then delete the folder, and the images in Docker Desktop (Images) if you want the space back.