ElizaOS server setup

Step by step guide to set up your Eliza server for running smart media templates

Using Railway (recommended)

You can setup your server in one click by deploying our Railway template directly.

For help with filling out the environment variables continue to the .env vars section below.

Manually

Until we've published the client, we encourage developers to fork our instance of Eliza at the client-bonsai branch.

GitHub - onbonsai/eliza at client-bonsaiGitHub

Once you've forked it you can deploy it to your server. You'll need to connect a MongoDB database and a Redis instance. We'll connect them to the server via the environment variables

.env vars

Now you can fill in the environment variables required for the Bonsai Client. The default .env.example for the ElizaOS server has entries for all of the included plugins but most (if not all) of these are not necessary unless you want to use their respective plugins.

For the ones required by the Bonsai Client scroll to the section that says # Bonsai Client Configuration

# Bonsai Client Configuration
TITLES_API_KEY=          # Your TITLES API key. This is required if you want to use the api from titles.xyz for image generation   
VENICE_API_KEY=          # Your VENICE API key. This is required if you want to use the api from venice.ai for image/text generation
SMALL_VENICE_MODEL="llama-3.1-405b"
BASE_RPC_URL=            # Your BASE RPC URL
BASE_SEPOLIA_RPC_URL=    # Your BASE SEPOLIA RPC URL
SUBGRAPH_API_KEY=        # Your SUBGRAPH API key for the Bonsai subgraph

NEXT_PUBLIC_JWKS_URI=    # Your NEXT PUBLIC JWKS URI
ISSUED_API_KEYS=         # Your ISSUED API KEYS. These are required to make calls to your server, you can put whatever you want.

BONSAI_CLIENT_MONGO_URI= # Your BONSAI CLIENT MONGO URI
MONGO_KEY=              # Your MONGO KEY
MONGO_IV=               # Your MONGO IV

REDIS_URL=              # Your REDIS URL
LARGE_OPENAI_MODEL=gpt-4.5-preview

LENS_STORAGE_NODE_ACCOUNT=  # Your LENS STORAGE NODE ACCOUNT
LENS_STORAGE_NODE_PRIVATE_KEY= # Your LENS STORAGE NODE PRIVATE KEY
GLOBAL_AGENT_ID=            # Your GLOBAL AGENT ID

DOMAIN=                   # Your DOMAIN where the app is hosted (can be ngrok for testing)
LENS_ENV=                 # testnet or mainnet

DISABLE_CREDITS=          # set to "true" to disable the api credit tracking system, leave blank otherwise

Install and run

1. pnpm install

2. pnpm build

3. pnpm run

Thats it! Your server is up and running and you can start building new Smart Media templates.