# Setting Up Your Server

Once you choose your plan, Genie begins setting up your dedicated server automatically.

This process happens in the background and requires no manual configuration. Your environment is provisioned, initialized, and connected without any input from you.

At the same time, you are guided into your first login experience.

## What Happens After Plan Selection

As soon as your plan is confirmed, Genie starts provisioning your server.

This includes:

* Allocating a dedicated Ubuntu-based environment
* Attaching persistent storage to your workspace
* Initializing your system directories
* Connecting your AI assistant to your environment

This entire process is automated and typically completes within a short time.

![Server Provisioning](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-170fcca8387d893861aac74ea2e05e88cb099048%2Fserver-provisioning.png?alt=media)

***

## Server Initialization

Your server runs a full Linux environment (Ubuntu 22.04), which behaves like a real machine.

By default, your workspace is prepared at:

```
/home/ubuntu/workspace
```

This is where all your files, projects, and applications will live.

Once the server is initialized, you have full control over the environment. You can install packages, run services, and configure your system just like any standard Linux machine.

![Genie Initiates](https://253630326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy3wRNrxvvjTFreyXSBOV%2Fuploads%2Fgit-blob-e30974e2a5b4a72bef9fb8a4a39df7119fa09229%2Fgenie-workspace.png?alt=media)

***

## First Login Experience

When you enter Genie for the first time, you are taken directly into your workspace.

There is no separate setup screen. Instead, you land inside a live environment that is already running.

You will see:

* A terminal connected to your server
* A file system with your workspace directory
* A chat interface with your AI assistant

At this point, your server is fully active and ready to use.

***

## Verifying Your Environment

You can immediately start interacting with your server.

For example, you can run:

```bash
pwd
```

This will confirm your current directory.

```bash
ls
```

This will list the contents of your workspace.

```bash
whoami
```

This will show your active user.

These commands behave exactly as they would on any Linux system, confirming that you are operating inside a real environment.

***

## Installing Tools and Dependencies

Since your server is a full Linux machine, you can install and manage tools freely.

For example:

```bash
sudo apt update
sudo apt install git -y
```

You can also use language-specific package managers:

```bash
npm install
pip install <package-name>
```

All installations are applied directly to your server and remain available across sessions.

***

## Persistence and State

One of the key aspects of Genie is persistence.

* Your files are saved on disk
* Your environment does not reset between sessions
* Installed tools remain available
* Your progress is never lost

Even if you disconnect or close your browser, your server continues to exist with the same state.

***

## Claude Setup Token

After your server is provisioned, you need to connect it to Claude for AI functionality.

### Connecting Claude

1. Go to **Settings → Server**
2. Under **Claude Setup Token (1-year)**, click to start the setup
3. A new tab will open to Claude's authorization page
4. Sign in to your Claude/Anthropic account and authorize access
5. Copy the authorization code from the callback page
6. Paste the code into the input field and click **Connect**
7. The setup will run through the following steps automatically:
   * ✅ Run claude setup-token
   * ✅ Open authorization page
   * ✅ Paste auth code
   * ✅ Generate & store token

### Verifying the Connection

Once connected, verify everything is working:

1. Go to **Chat**
2. Send a prompt to Genie
3. Genie should respond appropriately

If you receive a valid response, your Claude connection is active and ready to use.

### If the Setup Fails

* Try clicking **Re-open authorization page** and pasting the code again
* Make sure you're completing the authorization quickly — the code can expire
* If it still fails, delete the server and recreate it, then re-do the process from the beginning

***

## AI Integration During Setup

Your AI assistant is connected to your environment from the beginning.

It has access to:

* Your file structure
* Your commands and outputs
* Your active workspace

This allows it to assist you immediately, whether you are setting up a project, debugging issues, or running commands.

***

## What This Means

By the time you log in, there is nothing left to configure.

You are not setting up a machine. You are entering one that is already running.

Your terminal, files, and AI are all active and connected, allowing you to start working immediately.