Tutorials

Put your site on Spacefast

ShipPress v0.1.32 adds Spacefast as a second static deployment option alongside ShipPress hosting. Spacefast is Automattic's publishing platform for static sites. To use it, you need ShipPress 0.1.32 or later; if you already have a recent copy of the Mac, Windows & Linux app, it can update itself.

  1. What this is, and when not to use it

    Publishing to Spacefast deploys a static copy of your local site. Your pages and files are packed as a zip archive and uploaded to Automattic's platform. It is not a live WordPress install.

    For static sites only: member logins, a shop (WooCommerce), comments and anything else that needs WordPress running won't work. If your local site uses WooCommerce, the Free address tab is blocked, and the app prompts you to use a WordPress host instead.

    Pages that call PHP trigger a warning because dynamic features will not work on the static copy. Any other problem found in the copy stops the upload before it starts, and the app warns: Nothing was uploaded. Fix these first: followed by the list of issues. Note that custom domains, rollbacks, and running WordPress behind a Spacefast Space are not managed in ShipPress; configure those in the Spacefast dashboard if you need them.

  2. Get a Spacefast account and an API key

    ShipPress never opens a Spacefast account for you. You create your own account and API key on Spacefast's website, then paste the key into ShipPress.

    To create an account, go to spacefast.com, enter your email address, and click Continue to receive a six-digit verification code by email. You can also sign in with WordPress.com, Google, or GitHub if shown. Read the Spacefast authentication guide for details. Spacefast offers a free Personal plan at $0 with no credit card required, and commercial use is allowed. Check Spacefast pricing for current limits.

    API keys belong to a team, and only team owners and admins can create them. In the Spacefast dashboard, open your team and navigate to Agents, then find the API keys section. Create a key and copy the secret immediately. It starts with sfa_ and appears only once under a notice like Copy this key now. It won't be shown again. After that, the dashboard only shows a preview such as sfa_abcd...wxyz. Treat the key like a password: never put it in a chat, screenshot, or repository. For more information, see Spacefast API keys.

  3. Open Go live and choose Spacefast

    Open the site you want to publish. In the Mac, Windows & Linux app, click Go live at the top right. In Advanced mode, this button is labelled Deploy (see interface modes). The window is titled Put {name} online, or Put your site online if the site has no name yet.

    The window has three tabs under Ways to go online: Free address, WordPress host and Deploy yourself. Choose Free address. Under Where the static site goes, select Spacefast (the other option is ShipPress hosting).

    You can also connect the key first from the sidebar: click Hosting, find the Spacefast row, and click Connect to open the Connect Spacefast dialog. Then come back to Go live to publish.

  4. Paste the API key and connect

    In the Spacefast API key field, paste your key starting with sfa_. The app explains: The key is kept only in your computer's keychain. The AI and the logs never see it. You can also click the in-app help link How to get an API key ↗.

    Before you paste a key, Connect is disabled and the note reads Paste your API key first. Click Connect; the button shows Checking… while verifying. Once connected, the app shows Connected as {a} with a Disconnect button.

    If the key is rejected, the app displays Spacefast didn't accept this key. Make a new API key at spacefast.com and paste it here. If the key lacks a team, it shows This key isn't part of any Spacefast team, so it can't make Spaces. Use a key from a team. A 403 error means This Spacefast key isn't allowed to do that. Check its role and permissions at spacefast.com, or do it in the Spacefast dashboard. If you are on macOS and keychain saving fails, the app advises: Couldn't save the key to the system keychain. If macOS asked for access, choose Always Allow, then try again.

  5. Choose or create a Space

    Once connected, choose an existing Space or create a new one. Publishing to the same Space again keeps its address.

    If you have no Spaces yet, the app shows You have no Spaces yet. Make one below. Click + Make a new Space. Enter a Name (for example, My bakery) and an Address slug (for example, mybakery). The address can only use letters, numbers, and dashes (up to 40 characters) and previews as {slug}.space.fast. If the name is blank, the app warns: Type a name for the Space first. If the address slug is invalid, it warns: The address can only use letters, numbers and dashes. Type one in the Address field.

    Choose an access level: Private (Only your team and people with a share link can open it (a good start).) or Public (Anyone with the address can open it.). New Spaces default to private. Click Create Space. If a Space is already used by another local site, it displays In use by {names} and warns: This Space already holds {names}. Publishing replaces it with this site.

  6. Publish the static copy

    Select your Space and click Publish to Spacefast. If no Space is selected, the button is disabled and reads Choose a Space first. The window cannot be closed while publishing is running.

    The app shows its progress in order: Getting ready…, Copying pages and files… ({done} of {total}), Checking…, Packing the files…, Uploading to Spacefast…, and Waiting for Spacefast to put it online… (which can take up to 10 minutes).

    When finished, the app confirms: Online: {pages} pages, {files} files ({size} in all). and displays the live URL. If Spacefast is still finalizing the deployment, it shows: Sent to Spacefast, which is still putting it online. The address will work in a moment.

  7. Who can open it

    After publishing, the app explains who can view your site: It's public now: anyone with the address can open it. or It's private now: only your team can open it; everyone else sees "forbidden". If you did not change access on an existing Space, it notes: Public or private stays as this Space already had it. "Forbidden" when you open it means it is private.

    You can change visibility anytime using Make it public or Make it private. To share a private Space without requiring sign-in, click Get a share link; the app displays Share link (anyone who has it can look, no sign-in): followed by the share URL.

    You can also check your live address and connected Space in the Sites page and the Hosting page from the sidebar.

  8. Publish again, disconnect, or delete

    Whenever you update your local WordPress site, click Publish to Spacefast again. Publishing to the same Space keeps its address.

    To remove the API key from your computer's keychain, click Disconnect. Disconnecting removes the key locally; it does not delete your Space on Spacefast.

    To delete a Space, click Delete. The confirmation dialog asks: Delete {n} for good? and explains: The site and all its versions go away from Spacefast, and it can't be undone. The site on your computer isn't touched. Click Delete for good to confirm, or Cancel to keep it. If your API key lacks delete permissions, the button is disabled with: This API key can't delete Spaces. Delete it in the Spacefast dashboard.

  9. Where to go next

    Explore more publishing and export options in ShipPress: