Skip to main content
This guide is for contributors who want to run Keep locally for development. If you just want to use Keep, check out the Quickstart guide.

​
Prerequisites

Before you begin, ensure you have the following installed:
Install Solana CLI using the Anza installer to avoid SSL/archive issues:
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

​
Clone Repository

git clone https://github.com/seetadev/Storacha-Solana-SDK.git
cd Storacha-Solana-SDK
pnpm install

​
Start Local Validator

cd solana-programs

# On macOS, prevent resource fork issues
export COPYFILE_DISABLE=true

# Remove old ledgers if needed
rm -rf test-ledger

# Start validator
solana-test-validator

​
Deploy Solana Program

In a new terminal: 
cd solana-programs
anchor build
anchor deploy

​
Configure Server

cd server
cp .env.example .env

# Generate admin keypair
./scripts/generate-admin-key.sh
Edit .env and fill in:
  • Resend API key (get one here)
  • Database credentials
  • Storacha keys
  • Admin keypair from script output

​
Start Development Servers

cd server
pnpm dev

​
Get Test SOL

solana airdrop 2
If the airdrop fails due to rate limits, wait a few seconds and retry.

​
Verify Installation

  1. Open http://localhost:3000
  2. Connect your wallet (make sure it’s on testnet)
  3. Try uploading a test file
If you can successfully upload a file, your local setup is complete!

​
Troubleshooting

  • Ensure you used the Anza installer
  • Remove old ledgers: rm -rf test-ledger
  • Set COPYFILE_DISABLE=true on macOS
  • Make sure your wallet is set to testnet/devnet
  • Check that the test validator is running
  • Verify you have SOL in your wallet
  • Ensure you have enough SOL for the transaction
  • Check that the Solana program is deployed
  • Verify the server is running