Skip to main content

Server Setup

Step 1: Create directories​

mkdir -p claude-world/{config,workplace}
cd claude-world

Step 2: Download the files​

# Container init script
curl -fsSL https://raw.githubusercontent.com/Piero24/Claude-World/main/init.sh \
  -o init.sh
chmod +x init.sh

# Plain Docker Compose file
curl -fsSL https://raw.githubusercontent.com/Piero24/Claude-World/main/compose.yaml \
  -o compose.yaml

Step 3: Edit the values​

nano compose.yaml

Replace under the dev service:

  • CHANGE_ME_WEB_PASSWORD: login password for the ttyd web terminal
  • CHANGE_ME_SUDO_PASSWORD: sudo password, also used for SSH login
  • CHANGE_ME_ANTHROPIC_KEY: your Anthropic API key
  • CHANGE_ME_GIT_NAME / CHANGE_ME_GIT_EMAIL: your Git identity
  • CHANGE_ME_GITHUB_TOKEN: GitHub fine-grained PAT
  • TZ: your timezone

Step 4: Start the container​

docker compose up -d
docker ps | grep claude-world

You should see one container: claude-world.

Step 5: Test direct access​

TestURL / Command
Web terminalhttp://<server-ip>:7681, ttyd login (user: abc, pass: PASSWORD)
SSHssh abc@<server-ip> -p 2222, login with SUDO_PASSWORD

Both methods auto-launch Claude in /workplace. Exit Claude with /exit or Ctrl+D to get a normal shell prompt.

If both work and Claude starts, the container is running correctly.