ShipThis <a href="https://discord.gg/gPjn3S99k4"><img alt="discord" src="https://img.shields.io/discord/1304144717239554069?style=flat-square&label=%F0%9F%92%AC%20discord&color=00ACD7"></a><a href="https://shipth.is/?ref=github_readme"><img src="docs/assets/st.png" align="right" height="80" alt="ShipThis" /></a>

Build iOS and Android binaries (APK, AAB, IPA) for your Godot game
Publish to the App Store and Google Play when you are ready
Automatically manages certificates, keystores, API keys, and provisioning profiles
Free cloud builds for most solo devs

[!IMPORTANT] Currently in open beta and free to use. It will always be free for most solo devs.

Quick start

Requirements

A Godot 3.6 or 4.x game
Node.js version 18 or above
To publish an Android game - a Play Console Developer account (not required for building an APK/AAB)
To publish an iOS game - an Apple Developer account (not required for building an IPA)

1. Install ShipThis

Install via the NPM package manager:

npm install -g shipthis

2. Create an account

Set up an account with ShipThis by logging in for the first time using the shipthis login command.

shipthis login

3. Set up your game

Run the wizard command to configure your game on ShipThis; it will set up everything needed to automatically build and publish your Godot game.

The wizard command takes a platform parameter: either android or ios. Run the command from within a Godot game directory (with a project.godot file):

Set up an Android game

Read more about how ShipThis exports Godot Android games (Gradle vs legacy, APK/AAB output).

shipthis game wizard android

<details> <summary>Watch: Set up ShipThis for Android</summary> <picture> <img height="431" width="672" alt="ShipThis Command - Android Wizard - published game" src="docs/assets/wizard-android-existingx0.5.gif"> </picture> </details>

Set up an iOS game

shipthis game wizard ios

<details> <summary>Watch: Set up ShipThis for iOS</summary> <a href="https://www.youtube.com/watch?v=ijTUFVk1duw" target="_blank"> <img src="https://img.youtube.com/vi/ijTUFVk1duw/0.jpg" alt="Watch the iOS setup video" width="640" height="480"> </a> </details>

4. Ship

Now you can publish new versions of your game to TestFlight or Google Play with the shipthis game ship command:

shipthis game ship

New to ShipThis? See the full Quick start guide
Having issues? Check the Troubleshooting or join our Discord
For detailed documentation, visit shipth.is/docs

FAQ

Do I need a Mac to build for iOS?

No, you do not need a Mac, but if you want to publish to TestFlight or the Apple App Store then you will need an Apple Developer account.

ShipThis handles iOS builds on managed macOS cloud servers. The CLI connects to the Apple Developer Portal and sets everything up for you.

Which versions of Godot are supported?

We support all stable Godot versions since 3.6, including:

| 3.6 | 4.0 | 4.1 | 4.2 | 4.3 | 4.4 | 4.5 | 4.6 | | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | | 3.6.1 | 4.0.1 | 4.1.1 | 4.2.1 | 4.3.1 * | 4.4.1 | 4.5.1 | 4.6.1 | | 3.6.2 | 4.0.2 | 4.1.2 | 4.2.2 | | 4.4.2 * | | | | | 4.0.3 | 4.1.3 | 4.2.3 * | | | | | | | 4.0.4 | 4.1.4 | | | | | | | | 4.0.5 * | 4.1.5 * | | | | | |

* Custom builds - maintained by us to support Android SDK 35 and 16 KB Google Play compatibility requirement.

You can read more in our Godot versioning guide.

Can I build my game as APK/AAB/IPA without an Apple or Google account?

Yes.

The wizard command is designed to generate your own credentials for signing and publishing, but you might not need this when initially building your game.

You can create a ShipThis account, create the game and then run the ship command using demo credentials. Later, when you need to set up publishing, you can re-run the wizard command.

# Create a ShipThis game - run this in a dir with a project.godot file
shipthis game create --name "My Game"

# Run the build, use demo credentials, and

Cli

Install / Use

README