Documentation

Migration Guide

Moving from self-hosted Paperclip to HostAgentes? Here's how to migrate your agents with zero downtime.

1

Export your agent configuration

From your self-hosted Paperclip setup, export your agent configuration including model settings, tools, and behavior definitions.

2

Create a HostAgentes account

Sign up at hostagentes.com. Start with a free 24-hour Pro trial (credit card required; cancel before it ends and you won't be charged) to test the migration with unlimited agents.

3

Import your configuration

Use the dashboard import tool to upload your agent configuration. We will parse your config and create an equivalent agent on our platform.

4

Transfer persistent memory

Export your agent's vector store and key-value data, then import it from the dashboard. Your agent will remember everything it knew before.

5

Update your API endpoint

Point your application to the new HostAgentes API endpoint. Both endpoints can run in parallel during the transition.

6

Verify and decommission

Monitor both setups for 24–48 hours. Once correct operation is confirmed, decommission your self-hosted instance.

Estimated Time

30 min
Simple agent
1–2 hrs
Multi-agent setup
4–8 hrs
Enterprise migration

Zero-Downtime Migration

Your self-hosted instance and HostAgentes can run in parallel during migration. Update your API endpoint when you are ready — no need to take your agents offline. Once verified, decommission the old setup at your convenience.

What Gets Transferred

Agent configuration and behavior
Model provider configuration
Tool definitions
Persistent memory (vectors + KV)
Environment variables and secrets
Custom domain configuration
Team access and permissions
API rate limit configuration

Need help with migration? Our team can assist you.

Contact Support

Migration FAQ

How long does it take to migrate to HostAgentes?

About 30 minutes for a simple agent, 1–2 hours for a multi-agent setup, and 4–8 hours for an enterprise migration.

Can I migrate without downtime?

Yes. Your self-hosted instance and HostAgentes run in parallel during migration. Update your API endpoint when you are ready, verify, and decommission the old setup at your convenience — no need to take agents offline.

What gets transferred during migration?

Agent configuration and behavior, model provider configuration, tool definitions, persistent memory (vectors + KV), environment variables and secrets, custom domain configuration, team access and permissions, and API rate limit configuration.

Does HostAgentes help with migration?

Yes. The HostAgentes team can assist with your migration — contact support and they will help you move your self-hosted Paperclip agents to managed hosting.