Migrating from Beta to Production
HumanLayer runs two production-grade environments that are ready for SOC 2 customer data. Beta uses *.codelayer.cloud. Production uses *.humanlayer.com.
Your organization started on beta. Production is the long-term environment. This guide shows you how to move.
The short version:
- Nothing is lost. Your beta tasks, sessions, and artifacts stay on beta. You keep read access while you finish and export your work.
- Accounts do not transfer. Your admin creates a new organization on production and invites the team again. Each person accepts the new invite.
- Start new work on production. Finish active beta work at your own pace. There is no fixed cutoff date.
The transition at a glance
| Phase | Beta (codelayer.cloud) | Production (humanlayer.com) |
|---|---|---|
| Today | All your work lives here | Admin creates the new org, team accepts invites |
| Transition | Wrap up in-flight sessions | Start all new sessions here |
| Wind-down | Read access for reference and export | Your only day-to-day environment |
Guide for admins
Set up the production organization. Then invite the team.
- Create your new organization. Go to cloud.humanlayer.com and sign in. HumanLayer asks you to create an organization.
- Invite your team again. Send invites from cloud.humanlayer.com/admin/invitations. Each person needs a new invite because beta memberships do not transfer.
- Reconnect integrations. Slack, GitHub, Linear, and Jira connections are per-environment. Set them up again at cloud.humanlayer.com/admin/settings.
- Move new work to production. Start new sessions on production. Use beta only to finish active work.
Guide for users
Accept the invite. Your admin's email links to the production environment. Accept the invite and sign in.
Install the production app. Follow cloud.humanlayer.com/install, or run:
bashbrew trust --tap humanlayer/humanlayer brew install --cask humanlayer/humanlayer/humanlayer open /Applications/HumanLayer.appThe production app (
HumanLayer.app) installs next to the beta app (HumanLayer-Beta.app). You can keep both during the move.Use the browser if needed. Open app.humanlayer.com on a machine or phone.
Move remote daemons. If you run daemons with the CLI, log in again without the
--betaflag:bashhumanlayer login humanlayer daemon launchStart new sessions on production. Finish active beta work when you are ready.
Your data on beta
- All sessions stay on beta. HumanLayer does not delete them when you move.
- You keep read access to beta. You can read past work and export it. Ask the HumanLayer team for export help.
- Finish work at your own pace. HumanLayer will give you notice before beta access changes.
FAQ
Do I lose my beta sessions or artifacts? No. They stay on beta, and you keep read access. Ask the HumanLayer team for export help.
Why can't my account just move? Beta and production use separate databases and authentication. Accounts, organizations, and integrations exist in only one environment. The admin must create a new organization and invite everyone again.
Can I run the beta and production apps side by side? Yes. They install as different apps: HumanLayer-Beta.app and HumanLayer.app. You can keep both during the move.
Is beta being shut down? There is no fixed shutdown date. Do not start new work on beta. Finish active work there. HumanLayer will give you notice before beta access changes.
Was beta less secure than production? No. Both environments are production-grade and ready for SOC 2 customer data. Production is the long-term environment.
Do my Slack / GitHub / Linear / Jira integrations carry over? No. Your admin reconnects them on production at cloud.humanlayer.com/admin/settings.
What about my local workspace configuration? Files on your machine are not tied to an environment. These files include repositories, .humanlayer/workspace.json, and worktrees. After you sign in to production, select the same workspaces.
Who do I ask for help? Ask the HumanLayer team in your shared Slack channel or through your usual support channel. The team can help with exports and daemon moves.
Reference: URLs by environment
Beta services use codelayer.cloud. Production services use humanlayer.com.
| Surface | Beta | Production |
|---|---|---|
| Web app (browser & mobile) | app.codelayer.cloud | app.humanlayer.com |
| Cloud console (org, invites, settings) | cloud.codelayer.cloud | cloud.humanlayer.com |
| Install page | cloud.codelayer.cloud/install | cloud.humanlayer.com/install |
| Direct macOS download | update.codelayer.cloud/download/darwin-arm64 | update.humanlayer.com/download/darwin-arm64 |
| Homebrew cask | humanlayer/humanlayer/humanlayer-beta | humanlayer/humanlayer/humanlayer |
| macOS app bundle | HumanLayer-Beta.app | HumanLayer.app |
| CLI environment flag | humanlayer --beta … | none (production is the default) |
| API | riptide-api.codelayer.cloud | riptide-api.humanlayer.com |
| Sync service | sync.codelayer.cloud | sync.humanlayer.com |
| Docs | docs.humanlayer.com (shared) | docs.humanlayer.com |
Install commands
Production:
brew trust --tap humanlayer/humanlayer
brew install --cask humanlayer/humanlayer/humanlayer
open /Applications/HumanLayer.appBeta (only while wrapping up existing work):
brew trust --tap humanlayer/humanlayer
brew install --cask humanlayer/humanlayer/humanlayer-beta
open /Applications/HumanLayer-Beta.appCLI and remote daemons
The CLI defaults to production. The --beta flag targets beta.
# Production (new work)
humanlayer login
humanlayer daemon launch
# Beta (wrapping up)
humanlayer --beta login
humanlayer --beta daemon launchSee the remote daemons guide for launch tokens and full setup.