> For the complete documentation index, see [llms.txt](https://docs.infotopics.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infotopics.com/writebackextreme/getting-started/upgrade/migrate-to-another-server.md).

# Migrate to another server

If you need to move your **WriteBackExtreme** installation to a new server, follow the steps below based on your operating system. This ensures both your application files and repository database are safely transferred and functional.

***

#### 🪟 Windows Migration Steps

1. **Back up the current installation**
   * Create a full backup of your `WriteBackExtreme` directory
   * Back up the **repository database**
2. **Transfer to the new server**
   * Copy the entire `WriteBackExtreme` directory to the new machine
   * *(Optional)* If the repository database is hosted locally, migrate it to the new server as well
3. **Launch the application**
   * Run `WriteBackExtreme.exe` on the new server
4. **Update database settings if needed**
   * If your repository database location or credentials changed, update them in the configuration pane
5. **Re-enable the Windows Service (if used)**
   * Toggle the service setting off and back on to re-register the Windows service on the new host
6. **Update your DNS**
   * Point your (sub)domain DNS records to the new server IP
7. **Prevent duplicate connections**
   * Stop WriteBackExtreme on the original server to avoid simultaneous repository access

***

#### 🐧 Linux Migration Steps

1. **Back up the current installation**
   * Back up `/usr/local/share/writebackextreme`
   * Back up your **repository database**
2. **Prepare the new server**
   * Run the WriteBackExtreme installation script to set up dependencies
3. **Transfer application files**
   * Copy the backed-up `/usr/local/share/writebackextreme` directory to the new server
4. **Update configuration (if needed)**
   * Edit `wbe.config.yaml` to reflect any changes in the database location or credentials
5. **Start the WriteBackExtreme service**
   * Use `systemctl` or your preferred service manager to launch the application
6. **Update your DNS**
   * Point your (sub)domain DNS records to the new Linux server
7. **Prevent duplicate connections**
   * Shut down WriteBackExtreme on the previous server to avoid conflicting access to the same repository


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.infotopics.com/writebackextreme/getting-started/upgrade/migrate-to-another-server.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.