How to Set Up thirdweb Engine Quickly On Your Local Machine

How to Set Up thirdweb Engine Quickly On Your Local Machine

You'll learn how to set up thirdweb Engine instantly on your local machine.


3 min read

Previously, we learned how to deploy the thirdweb Engine in less than 3 minutes on the Railway platform using the template we created for the community.

In this blog, you'll learn how to deploy it on your local machine so you can explore and experiment with the thirdweb Engine for your next or current Web3 project.


Are you looking for a managed thirdweb Engine? Try Cloud-Hosted!


  1. Open your terminal on your local machine and execute the command below. It will clone my scripts into a new folder called engine.

     git clone engine

    A screenshot of a command line interface where a user clones a GitHub repository named "thirdweb-engine-deploy-locally" into a local directory, lists files in a directory, and navigates between directories.

  2. Navigate to the engine folder and open the file named .env.example. Fill out the required information. I prefer to use the Nano text editor in this guide because it is straightforward.

    A screenshot of a computer terminal showing the GNU nano text editor open with a file named ".env.example" containing environment variable settings for thirdweb engine.

    ADMIN_WALLET_ADDRESS โ†’ The wallet address that can manage your engine.
    THIRDWEB_API_SECRET_KEY โ†’ The thirdweb API secret key; get yours here.
    ENCRYPTION_PASSWORD โ†’ The string to encrypt sensitive data stored in DB.

    To save your changes in the Nano text editor, press CTRL+X. It will then ask you to confirm the save. Simply press Y and then hit ENTER to complete the process.
  3. After that, start Docker on your local machine and ensure it is running.

    Screenshot of Docker Desktop interface showing an empty state for running containers with informational tooltips about containers and how to run them.

  4. Now, return to your terminal and run npm run start, and it will handle everything for you. Watch your terminal pull the thirdweb engine docker image and set up your container. If you see the message below, your engine has been successfully deployed and is ready to use.

    A screenshot of a computer terminal displaying logs and warnings from a Node.js application, including messages about starting a PostgreSQL connection and listening on port 3005.

  5. Lastly, visit your endpoint URL at http://localhost:3005 , and you should see something like the example below. That's it! โœจ

    A screenshot of a computer screen displaying a JSON response message that reads "Engine is set up successfully. Manage your Engine from" in a code editor with a dark background.

Now that you have the endpoint URL, let's import your instance to the thirdweb Engine dashboard. Follow the steps here.

Try Engine Examples

To explore and experience the capabilities of thirdweb Engine, try some of our templates. Here are some of the best templates we have today for building with thirdweb Engine.


Screenshot of Mintcaster template

Bootstrap your own client on Farcaster, complete with a feed, cast functionality, and Sign-in with Farcaster auth, and add NFT minting functionality using the thirdweb Engine.

Phygital Experience

Screenshot of Phygital Experience template

Users can scan a QR code on a physical product to mint an NFT using the thirdweb engine. Perfect for buying and selling digital items physically.

Speed Racer

Screenshot of Speed Racers template

Try this template with the thirdweb Engine and Unreal game engine to build your own racing game powered by the blockchain.

That's all! Enjoy, and keep building! ๐Ÿซถ