Skip to content

Commit b793dd4

Browse files
Create migrating-cloud-server.md
1 parent 70a2679 commit b793dd4

File tree

1 file changed

+27
-0
lines changed

1 file changed

+27
-0
lines changed
Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
---
2+
layout: classic-docs
3+
title: "Migrating from Cloud to Server"
4+
short-title: "Migrating from Cloud to Server"
5+
description: "Migrating 2.0 Cloud projects to a 2.0 server installation"
6+
categories: [getting-started]
7+
order: 1
8+
---
9+
10+
*[Migration]({{ site.baseurl }}/2.0/migration/) > Migrating from Cloud to Server*
11+
12+
There is no formal process or toolset to migrate between CircleCI cloud (SaaS) to an installed CircleCI Server setup.
13+
The process is to perform a fresh install of CircleCI 2.0, using AWS and Terraform, see [Installation]({{ site.baseurl }}/2.0/aws/) for instructions.
14+
15+
Next, you will need to manually copy over all of your project settings including Contexts, environment variables, and API tokens.
16+
17+
**Note:** It is not possible to bring your projects' build histories from SaaS; you will have to re-add all of your projects to your Server installation.
18+
19+
Your 2.0 `config.yml` files should work as-is on Server, assuming they are working on SaaS. There are small differences between the 1.0 build environments that may result in some 1.0 configs not translating 100% from SaaS to Server.
20+
21+
Custom `machine` executor AMIs and configurable instance types are defined in a specific way, so consider how your teams may be using configurable resources, `resource_class`, on SaaS currently, when defining your build cluster.
22+
23+
## Limitations
24+
25+
- Currently `macos` executor is not supported on Server.
26+
- Bitbucket is not supported on Server, GitHub ENterprise is the only supported VCS.
27+

0 commit comments

Comments
 (0)