Start from Template

There are a couple templates that we offer to allow you to get started without any heavy lifting. The steps to get started are simple and easy to test in a few minutes.

Before You Start

Phala Cloud Next.js Starter

This is a template for developing a Next.js-based app with boilerplate code targeting deployment on Phala Cloud and DStack. It includes the SDK by default to make integration with TEE features easier. This repo also includes a default Dockerfile and docker-compose.yml for deployment.

Requirements

Development

First, you need to clone this repo:

git clone --depth 1 https://github.com/Phala-Network/phala-cloud-nextjs-starter.git

Next, let's initialize the development environment:

yarn
cp env.local.example .env.local

We also need to download the DStack simulator:

# Mac
wget https://github.com/Leechael/tappd-simulator/releases/download/v0.1.4/tappd-simulator-0.1.4-aarch64-apple-darwin.tgz
tar -xvf tappd-simulator-0.1.4-aarch64-apple-darwin.tgz
cd tappd-simulator-0.1.4-aarch64-apple-darwin
./tappd-simulator -l unix:/tmp/tappd.sock

# Linux
wget https://github.com/Leechael/tappd-simulator/releases/download/v0.1.4/tappd-simulator-0.1.4-x86_64-linux-musl.tgz
tar -xvf tappd-simulator-0.1.4-x86_64-linux-musl.tgz
cd tappd-simulator-0.1.4-x86_64-linux-musl
./tappd-simulator -l unix:/tmp/tappd.sock

Once the simulator is running, you need to open another terminal to start your Next.js development server:

yarn dev

By default, the Next.js development server will listen on port 3000. Open http://127.0.0.1:3000/ in your browser and check.

This repo also includes code snippets for the following common use cases:

  • /api/tdx_quote: The reportdata is test and generates the quote for attestation report via tdxQuote API.

  • /api/tdx_quote_raw: The reportdata is Hello DStack! and generates the quote for attestation report. The difference from /api/dx_quote is that you can see the raw text Hello DStack! in Attestation Explorer.

  • /api/eth_account/address: Using the deriveKey API to generate a deterministic wallet for Ethereum, a.k.a. a wallet held by the TEE instance.

  • /api/solana_account/address: Using the deriveKey API to generate a deterministic wallet for Solana, a.k.a. a wallet held by the TEE instance.

  • /api/info: Returns the TCB Info of the hosted CVM.

Build and Publish to Docker Registry

You need to build the image and push it to DockerHub for deployment. The following instructions are for publishing to a public registry via DockerHub:

Build and Publish with Docker CLI

docker build . -t <docker-username>/my-app:latest
docker push <docker-username>/my-app:latest

Build and Publish with Phala Cloud CLI

npx phala docker build -i my-app -t latest -f ./Dockerfile
npx phala docker push -i <docker-username>/my-app:latest

Now we have an official docker image for our nextjs app. Let's deploy to Phala Cloud now.

Deploy to Phala Cloud

You can copy and paste the docker-compose.yml file from this repo to see the example up and running.

Deploy in Phala UI

Go to your Phala Cloud dashboard and click Deploy. You will have an option for deploying via docker compose file. Click on this option to deploy.

You will come to a CVM configuration page. Click on Advanced and replace the default docker compose contents with the following (Make sure to replace the <docker-username>with your own:

services:
  app:
    image: <docker-username>/my-app:latest
    container_name: app
    ports:
      - "3000:3000"
    volumes:
      - /var/run/tappd.sock:/var/run/tappd.sock

Deploy via Phala Cloud CLI

For those using the CLI, you can deploy from the terminal with:

npx phala cvms create -c docker-compose.yml -n my-app

Interact with Your Next.js App in Phala Cloud

Your application should be deployed now to your Phala Cloud dashboard. Go to the Network tab to be able to open your application.

Conclusion

The last 2 tutorials were key to understanding the basics of deploying a Docker app on a TEE Server. Now you are ready to start building on Dstack! For more info on the design of Dstack, check out the Design Documents.

Last updated

Was this helpful?